Geztio Platform

What the Geztio Platform MCP server does

The Geztio Platform MCP server connects MCP-compatible AI clients with Geztio, a construction project management and economic engineering platform. It provides access to project economics and operational records, including Unit Price Analysis (APU) recipes, resource catalogs, dynamic price lists, projects, and CBS budget structures.

Read operations support searching and inspection. An agent can find APUs by name or code, review resource prices, inspect project status, retrieve a project overview, and traverse a budget tree with quantities and line totals. The available data is scoped to the authenticated member’s organization.

Write operations are available for accounts with the relevant scopes. These include creating or editing unit cost recipes, registering resources, creating projects and budget chapters, changing budget item quantities, and starting bulk resource imports.

How it works

The Geztio Platform MCP server is delivered as a remote Streamable HTTP endpoint at https://mcp.geztio.co/mcp. An MCP client initializes a session and discovers the available tools. Custom agents can connect through the official MCP Python or TypeScript SDKs.

Authentication is handled through OAuth 2.0. Access is organization-isolated, and the authenticated member’s seat tier affects which cost fields are visible. Full-seat users can see direct costs, currencies, and line totals. Field-seat users can access project quantities, recipes, and scopes while cost fields are masked as null.

The server also provides prompt templates for APU analysis, comparing similar unit costs, and auditing price lists. URI-addressable resources expose JSON representations for projects and unit cost recipes.

Setup and configuration

No local process or environment variable is specified for the hosted endpoint. In Claude Desktop, add the endpoint as a remote MCP server using the URL above. In Cursor, add a new MCP server with the Streamable HTTP type and the same URL. The first Claude Desktop connection starts the OAuth 2.0 authentication flow for the Geztio organization and member account.

Custom agents can use the MCP SDK’s Streamable HTTP client, initialize a session, and list the server’s tools. The README also names Claude Code, Windsurf, and Antigravity as supported connection contexts, but does not provide separate configuration examples for them.

Tools and capabilities

The tool groups cover:

• Identity: identify the authenticated member, organization, seat tier, and subscription plan.
• Unit costs: search APUs, retrieve detailed recipes, and add or remove recipe items.
• Resources and prices: search materials, labor, equipment, and transport; create resources; and list active price lists.
• Projects and budgets: search projects, retrieve project overviews, create projects, inspect CBS trees, create chapters, and update item quantities.
• Operations: enqueue asynchronous resource imports and check execution progress, errors, and quota usage.

Write access depends on scopes such as unit_costs:write, resources:write, budgets:write, projects:write, and operations:write. Read access uses geztio:read.

Limitations and notes

The Geztio Platform MCP server requires an authenticated Geztio account and organization context. Cost visibility is not uniform across seat tiers, so field users may receive null for cost values. Bulk resource imports are asynchronous and return an execution ID that must be checked with the execution-status tool.

The repository describes the hosted Streamable HTTP service and SDK usage, not a local stdio deployment. It also does not document environment variables for connecting to the hosted server. The repository is licensed under MIT.