{
  "markdown": "# Geztio MCP Server (`co.geztio/platform`)\n\nOfficial Model Context Protocol (MCP) server for **[Geztio](https://geztio.co)** — the modern construction project management and economic engineering platform.\n\nConnect AI assistants (Claude Desktop, Cursor, Claude Code, Windsurf, Antigravity, custom agents) directly to Geztio's Unit Price Analysis (APU / *Análisis de Precios Unitarios*), CBS budget trees, dynamic price lists, resource catalogs, and project operations.\n\n[![Official MCP Server](https://img.shields.io/badge/MCP%20Registry-co.geztio%2Fplatform-blue)](https://registry.modelcontextprotocol.io)\n[![Transport](https://img.shields.io/badge/Transport-Streamable%20HTTP-brightgreen)](https://modelcontextprotocol.io/specification/2026-07-28)\n[![License](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n\n---\n\n## 🏗️ Overview\n\nGeztio provides construction companies, project managers, cost engineers, and field teams with a single source of truth for project economics. Through this MCP server, AI models can:\n\n- **Search & Analyze APUs (`UnitCost`)**: Look up composition breakdown, yields, unit costs, and nested recipes across material, equipment, labor, and transport.\n- **Query Resource Catalogs (`Resource`)**: Search materials, equipment, labor, and transport insumos with their dynamically resolved unit prices.\n- **Explore CBS & Budget Scenarios (`BudgetTree`)**: Traverse project chapters and budget items, inspecting quantities, locations, and line-item totals.\n- **Audit & Compare Price Lists (`PriceList`)**: Detect pricing outliers, verify regional price lists, and simulate scenario variations.\n- **Execute Asynchronous Operations**: Bulk-import resources and track execution task status.\n\n---\n\n## ⚡ Quick Start & Configuration\n\n### 1. Claude Desktop\n\nAdd Geztio as a remote MCP server in your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"geztio\": {\n      \"url\": \"https://mcp.geztio.co/mcp\"\n    }\n  }\n}\n```\n\n*When connecting for the first time, Claude Desktop will automatically initiate the OAuth 2.0 handshake to authenticate your Geztio organization and member account.*\n\n### 2. Cursor IDE\n\nIn Cursor Settings → Features → MCP:\n1. Click **+ Add New MCP Server**.\n2. **Name**: `geztio`\n3. **Type**: `Streamable HTTP`\n4. **URL**: `https://mcp.geztio.co/mcp`\n\n### 3. Antigravity & Agentic Frameworks\n\nTo connect from custom agents using the official `@modelcontextprotocol/sdk` or Python SDK:\n\n```python\nfrom mcp import ClientSession\nfrom mcp.client.streamable_http import streamablehttp_client\n\nasync with streamablehttp_client(\"https://mcp.geztio.co/mcp\") as (read, write):\n    async with ClientSession(read, write) as session:\n        await session.initialize()\n        tools = await session.list_tools()\n        print([t.name for t in tools])\n```\n\n---\n\n## 🛡️ Security & Multi-Tenancy\n\n- **Organizational Scoping**: Every query is strictly isolated to the authenticated member's organization.\n- **Seat Tier Cost Masking**:\n  - `SeatTier.FULL`: Office users and project managers see all direct costs, currencies, and line totals.\n  - `SeatTier.FIELD`: Site supervisors and field execution members see project quantities, recipes, and scopes with cost fields safely masked as `null`.\n- **Granular Scopes**:\n  - `geztio:read`: Read-only access to catalogs, budgets, projects, and price lists.\n  - `unit_costs:write`: Create or update APU unit costs and item recipes.\n  - `resources:write`: Create or update catalog resources.\n  - `budgets:write`: Create budget chapters and update budget item quantities.\n  - `projects:write`: Create new projects.\n  - `operations:write`: Enqueue bulk imports and batch jobs.\n\n---\n\n## 🛠️ Tool Catalog\n\n### Identity & Context\n| Tool | Scope | Description |\n|---|---|---|\n| `geztio_whoami` | `geztio:read` | Identifies the authenticated member, organization, seat tier (`sees_money`), and active subscription plan. |\n\n### Unit Cost Analysis (APU / UPA)\n| Tool | Scope | Description |\n|---|---|---|\n| `geztio_search_unit_costs` | `geztio:read` | Search APUs by name or code with optional filtering by nested type and project. |\n| `geztio_get_unit_cost_detail` | `geztio:read` | Detailed APU breakdown with itemized resources, yields, waste factors, and resolved costs against a specified `PriceList`. |\n| `geztio_create_unit_cost` | `unit_costs:write` | Create a new unit cost recipe in the organization or project catalog. |\n| `geztio_add_unit_cost_item` | `unit_costs:write` | Add a resource item (material, labor, equipment, transport) to an APU recipe. |\n| `geztio_remove_unit_cost_item` | `unit_costs:write` | Remove an item from an APU recipe. |\n\n### Resources (Insumos) & Price Lists\n| Tool | Scope | Description |\n|---|---|---|\n| `geztio_search_resources` | `geztio:read` | Search resources (materials, labor, equipment, transport) with resolved unit prices. |\n| `geztio_create_resource` | `resources:write` | Register a new resource with unit and pricing mode. |\n| `geztio_list_price_lists` | `geztio:read` | List active price lists (regional, standard, project-specific). |\n\n### Projects, Budgets & CBS Chapters\n| Tool | Scope | Description |\n|---|---|---|\n| `geztio_search_projects` | `geztio:read` | Search projects by name, code, and execution status. |\n| `geztio_get_project_overview` | `geztio:read` | Complete overview of a project including its active contract budget and scenario version. |\n| `geztio_create_project` | `projects:write` | Create a new project in the organization. |\n| `geztio_get_budget_tree` | `geztio:read` | Full Work Breakdown Structure (WBS/CBS) chapter tree with quantities and line totals. |\n| `geztio_create_chapter` | `budgets:write` | Create a new chapter node in a budget version's CBS hierarchy. |\n| `geztio_update_budget_item_quantity` | `budgets:write` | Update line item quantity in a budget version. |\n\n### Operations & Batch Processing\n| Tool | Scope | Description |\n|---|---|---|\n| `geztio_import_resources` | `operations:write` | Asynchronously bulk-import or update resource catalogs. Returns an `execution_id`. |\n| `geztio_get_execution_status` | `geztio:read` | Poll progress, errors, and token/quota usage for asynchronous executions. |\n\n---\n\n## 💬 Prompts\n\nThe server includes pre-built MCP Prompt templates:\n\n1. **`analizar_unit_cost`**: Technical analysis of an APU (composition, yields, price coherence, and optimization recommendations).\n2. **`comparar_unit_costs`**: Comparative analysis between two similar APUs (differential items, cost variance, and recommended usage).\n3. **`auditar_lista_de_precios`**: Automated audit of a price list to flag statistical outliers, missing prices, or suspicious variances.\n\n---\n\n## 📦 Resources\n\nProvides stable, URI-addressable references:\n\n- `geztio://project/{ref}`: Direct JSON representation of a project.\n- `geztio://unit-cost/{ref}`: Direct JSON representation of an APU recipe.\n\n---\n\n## 🚀 Publishing & Registry Maintenance\n\nThis repository publishes metadata to the **Official MCP Registry** using `mcp-publisher`.\n\n### Domain Authentication (`geztio.co`)\n\nDomain ownership for the namespace `co.geztio/*` is verified via DNS TXT record:\n\n```text\ngeztio.co. IN TXT \"v=MCPv1; k=ed25519; p=<PUBLIC_KEY_BASE64>\"\n```\n\n### Manual Publish\n\n```bash\n# 1. Login with domain private key\nmcp-publisher login dns --domain \"geztio.co\" --private-key \"$MCP_REGISTRY_PRIVATE_KEY\"\n\n# 2. Publish server.json\nmcp-publisher publish\n```\n\n---\n\n## 📄 License\n\nThis repository is licensed under the [MIT License](LICENSE).\n",
  "bytes": 7496,
  "sha": "93344b94e9f213d9f72ab2ebad8e60629f8eb76810e7d14f474a2f43d9ca4dfe",
  "repo_slug": "geztio/mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_co_geztio_platform_5532de7f/readme"
}