Skip to main content
Glama
co.geztio/platform

co.geztio/platform

Official
by geztio

Geztio MCP Server (co.geztio/platform)

Official Model Context Protocol (MCP) server for Geztio — 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.

Official MCP Server Transport License


🏗️ 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.


Related MCP server: Construction MCP Server

⚡ 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

Tool

Scope

Description

geztio_whoami

geztio:read

Identifies the authenticated member, organization, seat tier (sees_money), and active subscription plan.

Unit Cost Analysis (APU / UPA)

Tool

Scope

Description

geztio_search_unit_costs

geztio:read

Search APUs by name or code with optional filtering by nested type and project.

geztio_get_unit_cost_detail

geztio:read

Detailed APU breakdown with itemized resources, yields, waste factors, and resolved costs against a specified PriceList.

geztio_create_unit_cost

unit_costs:write

Create a new unit cost recipe in the organization or project catalog.

geztio_add_unit_cost_item

unit_costs:write

Add a resource item (material, labor, equipment, transport) to an APU recipe.

geztio_remove_unit_cost_item

unit_costs:write

Remove an item from an APU recipe.

Resources (Insumos) & Price Lists

Tool

Scope

Description

geztio_search_resources

geztio:read

Search resources (materials, labor, equipment, transport) with resolved unit prices.

geztio_create_resource

resources:write

Register a new resource with unit and pricing mode.

geztio_list_price_lists

geztio:read

List active price lists (regional, standard, project-specific).

Projects, Budgets & CBS Chapters

Tool

Scope

Description

geztio_search_projects

geztio:read

Search projects by name, code, and execution status.

geztio_get_project_overview

geztio:read

Complete overview of a project including its active contract budget and scenario version.

geztio_create_project

projects:write

Create a new project in the organization.

geztio_get_budget_tree

geztio:read

Full Work Breakdown Structure (WBS/CBS) chapter tree with quantities and line totals.

geztio_create_chapter

budgets:write

Create a new chapter node in a budget version's CBS hierarchy.

geztio_update_budget_item_quantity

budgets:write

Update line item quantity in a budget version.

Operations & Batch Processing

Tool

Scope

Description

geztio_import_resources

operations:write

Asynchronously bulk-import or update resource catalogs. Returns an execution_id.

geztio_get_execution_status

geztio:read

Poll progress, errors, and token/quota usage for asynchronous executions.


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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI assistants to query multi-cloud cost and usage data through a uniform read-only toolset, including cost summaries, trends, budgets, forecasts, and optimization recommendations.
      MIT
    • F
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to query live construction project data such as RFIs, submittals, budget variance, daily logs, punch lists, and inspection checklists.
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI clients to query construction management companies, projects, and directory data, and to create safety-gated draft records without permitting terminal commitments. It also provides credential resolution, context compression, audit logging, mock/demo sandbox modes, and remote transports for enterprise deployments.
      Business Source 1.1
    • A
      license
      A
      quality
      C
      maintenance
      Gives AI assistants access to Brazil's official construction cost databases (SINAPI, SICRO, ORSE and SEINFRA) by downloading the public files into a local SQLite database, so users can search compositions and inputs, compare prices across states, track price history, build quick budgets and compute BDI using the TCU Ruling 2622/2013 formula and ranges. Everything is fetched on demand straight from the government sources, with older price periods kept locally so budgets can be rebuilt at any date.
      7
      2
      MIT