Omnicost

com.omnicostPublished by omnicost.comOfficial publisherv1.1.0Updated Nov 2, 2026

Construction unit prices with source and date for Spain, the US and the EU. OAuth or API key.

VerifiedStreamable HTTPWeb executableData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Omnicost gives an assistant read-only access to a construction cost catalog with sourced unit prices for Spain, the US and the EU.

What you can do
  • Search the catalog semantically by free-text query, with optional limit and region, returning median price and vendor count
  • Fetch a single item with its vendor breakdown and recent prices, each with its source
  • List the top-level catalog categories
  • Get the BC3 recipe tree for an item, breaking it into material, labor and machinery components per unit
When to use it
Useful when estimating construction or renovation costs, checking unit prices for materials, labor or equipment, or building up a cost breakdown for a project in Spain, the US or the EU.
Requirements
Remote streamable HTTP endpoint; nothing to install. Sign in with a free Omnicost account via OAuth, or send an organization API key as a Bearer token in the Authorization header. Claude Desktop needs Node.js for mcp-remote. Free tier is limited to 200 requests a minute and 10,000 a month; Pro raises it to 100,000 a month.
Before you install
The API key is a secret: keep it out of version control and pass it via the Authorization header. Without a key or sign-in, each tool call costs $0.01 in USDC on Base via x402. Pro plans are paid ($9/week, $29/month or $290/year). Access is read-only, but queries and workspace identity go to Omnicost.

Installation

In SourceWeft

  1. Open Omnicost in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/com.omnicost%2Fcatalog/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "omnicost": {
      "type": "http",
      "url": "https://omnicost.com/api/mcp"
    }
  }
}

README

[Omnicost]

Omnicost MCP server

Construction unit prices with source and date for Spain, the US and the EU, available to AI agents over the Model Context Protocol.

Omnicost is a construction cost catalog and estimating tool. It gathers unit prices for materials, labor and equipment from 208 sources such as public tenders and supplier catalogs, and keeps the source and observed date on every price. The catalog holds about 81,000 priced items, and coverage is strongest in Spain, the United States and the European Union. This repository holds the public listing for the hosted MCP server: its server.json for MCP registries and ready-to-use client configs.

The server itself is hosted by Omnicost. There is nothing to install or run from this repo.

Endpointhttps://omnicost.com/api/mcp
TransportStreamable HTTP
AuthSign in with your Omnicost account (OAuth 2.1 + PKCE), or Authorization: Bearer <API key>
Registry namecom.omnicost/catalog
Websitehttps://omnicost.com

Connect with your Omnicost account

Claude, ChatGPT and Claude Code can connect by signing in. You need a free Omnicost account; no API key to copy.

  • Claude (claude.ai and Claude Desktop): Settings → Connectors → Add custom connector. Paste https://omnicost.com/api/mcp and click Connect.
  • ChatGPT: Settings → Apps & Connectors, turn on developer mode and create a connector with the URL https://omnicost.com/api/mcp and OAuth authentication.
  • Claude Code: claude mcp add --transport http omnicost https://omnicost.com/api/mcp, then run /mcp and pick omnicost to sign in.

The client opens an Omnicost sign-in page. Sign in (or create an account), pick the workspace to connect and approve read-only catalog access. The connection uses that workspace's plan: Omnicost Pro limits on Pro, otherwise the free tier (200 requests a minute, 10,000 a month). Access tokens last 1 hour and refresh on their own for 30 days.

Any other client that supports MCP authorization can do the same: the server answers 401 with WWW-Authenticate: Bearer resource_metadata="https://omnicost.com/.well-known/oauth-protected-resource/api/mcp", and the authorization server supports dynamic client registration and Client ID Metadata Documents.

Connect with an API key

For clients without OAuth, or for scripts:

  1. Sign up at https://omnicost.com/en and create your workspace.
  2. Open https://omnicost.com/dashboard/mcp and create an organization API key.
  3. Add it to your MCP client config as shown below.

Without a key or a sign-in, initialize, tools/list and ping are free, and each tools/call costs $0.01 in USDC on Base via x402. Claude and ChatGPT get a 401 instead, which starts their sign-in.

Tools

ToolWhat it does
search_catalogSemantic search over the catalog. Takes a free-text query (q), an optional limit (up to 25) and an optional region. Returns matching items with median price and vendor count.
get_itemFetches one item (ci_... id) with its vendor breakdown and recent prices, each with its source.
list_categoriesLists the top-level catalog categories.
get_decompositionReturns the BC3 recipe for an item: the material, labor and machinery components per unit.

For useful results, query items priced in Spain, the US or the EU.

Client setup with an API key

Replace the placeholder with your organization API key. Keep the key out of version control. Clients that support OAuth can skip the key; see above.

Cursor

~/.cursor/mcp.json or .cursor/mcp.json in your project (examples/cursor.mcp.json):

json
{  "mcpServers": {    "omnicost": {      "url": "https://omnicost.com/api/mcp",      "headers": {        "Authorization": "Bearer ${env:OMNICOST_API_KEY}"      }    }  }}

VS Code

.vscode/mcp.json (examples/vscode.mcp.json). VS Code asks for the key the first time and stores it for you:

json
{  "inputs": [    {      "type": "promptString",      "id": "omnicost-key",      "description": "Omnicost API key",      "password": true    }  ],  "servers": {    "omnicost": {      "type": "http",      "url": "https://omnicost.com/api/mcp",      "headers": {        "Authorization": "Bearer ${input:omnicost-key}"      }    }  }}

Claude Desktop

Claude Desktop talks to remote servers through mcp-remote, so you need Node.js installed. Add this to claude_desktop_config.json (examples/claude-desktop.json):

json
{  "mcpServers": {    "omnicost": {      "command": "npx",      "args": [        "-y",        "mcp-remote",        "https://omnicost.com/api/mcp",        "--header",        "Authorization:Bearer ${OMNICOST_API_KEY}"      ],      "env": {        "OMNICOST_API_KEY": "<your key>"      }    }  }}

Any other client

Point a client that supports streamable HTTP at https://omnicost.com/api/mcp. Either let it sign in with OAuth or send the key as a Bearer token in the Authorization header.

Pricing

A free account can connect by OAuth or with an organization API key. Omnicost Pro ($9/week, $29/month or $290/year) includes API and MCP access with 100,000 requests a month. See https://omnicost.com/en/pricing.

More

License

The contents of this repository are released under the MIT License. Omnicost is a product of Ipita LLC.

Source: README.md at commit 8008b5f

Tools

4

search_catalog

Search construction cost catalog

Semantic search for canonical construction-cost items. Returns top-K matches with median price, vendor count, and source trust. Deprecated in structuredContent.results (kept for one release): score, category_id.

Parametersqrequiredlimitregion

get_item

Get catalog item

Fetch a canonical item with vendor breakdown and recent price history. Returns Markdown for readability. Deprecated in structuredContent (kept for one release): item.category_id.

Parametersidrequired

list_categories

List catalog categories

Catalog categories: structuredContent.categories items are {id, name, parentId, parent} where parent is the parent category's name. Deprecated (kept for one release): id, parentId.

Takes no parameters.

get_decomposition

Get item cost breakdown

BC3 recipe tree for an item: material+labor+machinery components per unit. Returns parent_code and component rows {child_code, factor, yield, per_unit, name, unit, unit_price, item_id}; item_id (vsku_…) can be passed back to get_decomposition. Deprecated (kept for one release): parentId, parentCode, and per component catalog_item_id and position.

Parametersitem_idrequired

Version history

2
  1. v1.1.0LatestNov 2, 2026
  2. v1.0.0Oct 29, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts