Omnicost

com.omnicost由 omnicost.com 發布官方發布者v1.1.0更新於 Nov 2, 2026

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

已驗證Streamable HTTP可網頁執行資料與分析商業與電商

概覽

AI 產生的概覽

Omnicost 讓助理以唯讀方式查詢建築成本目錄,取得西班牙、美國與歐盟附來源與日期的單位價格。

可以做什麼
  • 以自由文字語意搜尋目錄,可限制筆數與地區,回傳中位價與供應商數量
  • 取得單一條目及其供應商明細與近期價格,每筆價格附上來源
  • 列出目錄的頂層分類
  • 取得條目的 BC3 配方樹,依單位拆分為材料、人工與機械組成
適用情境
適合估算建築或裝修成本、核對材料人工設備單價,或為西班牙、美國、歐盟的專案整理成本明細時使用。
執行需求
遠端 streamable HTTP 端點,無需安裝。可用免費 Omnicost 帳號透過 OAuth 登入,或在 Authorization 標頭以 Bearer 方式送出組織 API 金鑰。Claude Desktop 需安裝 Node.js 以執行 mcp-remote。免費額度為每分鐘 200 次、每月 10,000 次請求;Pro 提高至每月 100,000 次。
安裝前請注意
API 金鑰屬於機密,請勿提交到版本控制,應透過 Authorization 標頭傳遞。未提供金鑰或未登入時,每次工具呼叫需經 x402 以 Base 鏈上的 USDC 支付 0.01 美元。Pro 為付費方案(每週 9 美元、每月 29 美元或每年 290 美元)。存取為唯讀,但查詢內容與工作區身分會傳送給 Omnicost。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Omnicost,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/com.omnicost%2Fcatalog/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "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.

來源:README.md,提交 8008b5f

工具

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.

輸入參數q必填limitregion

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.

輸入參數id必填

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.

無需輸入參數。

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.

輸入參數item_id必填

版本歷史

2
  1. v1.1.0最新Nov 2, 2026
  2. v1.0.0Oct 29, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分