Geztio Platform

Geztio MCP Server (co.geztio/platform)

Official Model Context Protocol (MCP) server for [Geztio](https://geztio.co) — the modern construction project management and economic engineering platform.

Connect 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.

---

🏗️ Overview

Geztio 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:

• Search & Analyze APUs (`UnitCost`): Look up composition breakdown, yields, unit costs, and nested recipes across material, equipment, labor, and transport.
• Query Resource Catalogs (`Resource`): Search materials, equipment, labor, and transport insumos with their dynamically resolved unit prices.
• Explore CBS & Budget Scenarios (`BudgetTree`): Traverse project chapters and budget items, inspecting quantities, locations, and line-item totals.
• Audit & Compare Price Lists (`PriceList`): Detect pricing outliers, verify regional price lists, and simulate scenario variations.
• Execute Asynchronous Operations: Bulk-import resources and track execution task status.

---

⚡ Quick Start & Configuration

1. Claude Desktop

Add Geztio as a remote MCP server in your claude_desktop_config.json:

{

"mcpServers": { "geztio": { "url": "https://mcp.geztio.co/mcp" } } }

*When connecting for the first time, Claude Desktop will automatically initiate the OAuth 2.0 handshake to authenticate your Geztio organization and member account.*

2. Cursor IDE

In Cursor Settings → Features → MCP:

1. Click + Add New MCP Server.
2. Name: geztio
3. Type: Streamable HTTP
4. URL: https://mcp.geztio.co/mcp

3. Antigravity & Agentic Frameworks

To connect from custom agents using the official @modelcontextprotocol/sdk or Python SDK:

from mcp import ClientSession

from mcp.client.streamable_http import streamablehttp_client

async with streamablehttp_client("https://mcp.geztio.co/mcp") as (read, write): async with ClientSession(read, write) as session: await session.initialize() tools = await session.list_tools() print([t.name for t in tools])

---

🛡️ Security & Multi-Tenancy

• Organizational Scoping: Every query is strictly isolated to the authenticated member's organization.
• Seat Tier Cost Masking:
• SeatTier.FULL: Office users and project managers see all direct costs, currencies, and line totals.
• SeatTier.FIELD: Site supervisors and field execution members see project quantities, recipes, and scopes with cost fields safely masked as null.
• Granular Scopes:
• geztio:read: Read-only access to catalogs, budgets, projects, and price lists.
• unit_costs:write: Create or update APU unit costs and item recipes.
• resources:write: Create or update catalog resources.
• budgets:write: Create budget chapters and update budget item quantities.
• projects:write: Create new projects.
• operations:write: Enqueue bulk imports and batch jobs.

---

🛠️ Tool Catalog

Identity & Context

Unit Cost Analysis (APU / UPA)

Resources (Insumos) & Price Lists

Projects, Budgets & CBS Chapters

Operations & Batch Processing

---

💬 Prompts

The server includes pre-built MCP Prompt templates:

1. `analizar_unit_cost`: Technical analysis of an APU (composition, yields, price coherence, and optimization recommendations).
2. `comparar_unit_costs`: Comparative analysis between two similar APUs (differential items, cost variance, and recommended usage).
3. `auditar_lista_de_precios`: Automated audit of a price list to flag statistical outliers, missing prices, or suspicious variances.

---

📦 Resources

Provides stable, URI-addressable references:

• geztio://project/{ref}: Direct JSON representation of a project.
• geztio://unit-cost/{ref}: Direct JSON representation of an APU recipe.

---

🚀 Publishing & Registry Maintenance

This repository publishes metadata to the Official MCP Registry using mcp-publisher.

Domain Authentication (geztio.co)

Domain ownership for the namespace co.geztio/* is verified via DNS TXT record:

geztio.co. IN TXT "v=MCPv1; k=ed25519; p=<PUBLIC_KEY_BASE64>"

Manual Publish

# 1. Login with domain private key

mcp-publisher login dns --domain "geztio.co" --private-key "$MCP_REGISTRY_PRIVATE_KEY"

2. Publish server.json

mcp-publisher publish

---

📄 License

This repository is licensed under the MIT License.