API operation

io.github.ladanyin由 GitHub 帳號 ladanyin 發布v1.0.0更新於 Nov 5, 2026

Read one operation from a public OpenAPI document: method, path, and required fields.

已驗證Streamable HTTP可網頁執行知識與記憶開發者工具

概覽

AI 產生的概覽

遠端 MCP 伺服器，從公開的 OpenAPI、Swagger 或簡易 YAML 文件中讀取單一操作，回傳方法、路徑與必填欄位。

可以做什麼
  • 透過文件網址與簡短意圖（例如「建立寵物」），從公開的 OpenAPI/Swagger JSON 或簡易 YAML 文件中查找一個 API 操作。
  • 回傳最相符的結果，包含方法、路徑、操作 id、摘要以及必填參數與請求主體欄位。
適用情境
適合助手在呼叫公開 API 前，需要從規格文件中找出正確端點與必填輸入，又不想把整份文件放進上下文的情況。
執行需求
遠端 streamable HTTP 端點，無需本機安裝。需要 API 金鑰，透過 X-API-Key 標頭傳送，須在供應商網站註冊取得。README 說明新金鑰含 20 點額度，更多額度需另行購買。
安裝前請注意
API 金鑰是每次呼叫都會傳送的機密，請勿寫入日誌或共用紀錄。呼叫會消耗付費額度（README 列出該供應商其他工具的單次價格與以歐元計價的額度方案），可能產生費用。文件網址與意圖會傳送到供應商伺服器。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 API operation，將其新增到工作區。
  2. 連接 X-API-Key 憑證。它們會被私密儲存，絕不會在公開頁面上展示。
  3. 為需要使用其工具的對話啟用該服務。

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

交給代理程式安裝

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

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

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

其他 MCP 客戶端

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

{
  "mcpServers": {
    "api-operation": {
      "type": "http",
      "url": "https://spec.bestsmartgoods.com/mcp",
      "headers": {
        "X-API-Key": "<YOUR_API_KEY>"
      }
    }
  }
}

README

Company lookup, invoice reading, citation check

Three remote MCP servers for other agents. One API key. New keys include 20 credits.

Get a key: https://firm.bestsmartgoods.com/signup

Buy credits: https://firm.bestsmartgoods.com/buy

Send the key on every call:

X-API-Key: ak_...

Company lookup

Find a company by name, registration number, or tax id. 0.05 credit per successful call.

MCP: https://firm.bestsmartgoods.com/mcp · tool lookup_company

bash
curl -X POST https://firm.bestsmartgoods.com/v1/companies/lookup \
  -H "X-API-Key: ak_..." \
  -H "Content-Type: application/json" \
  -d "{\"query\":\"MOL Magyar Olaj\",\"country\":\"HU\"}"

Invoice reading

Read an invoice or text file into seller, tax id, date, and amounts. 0.15 credit per successful call.

MCP: https://bill.bestsmartgoods.com/mcp · tool parse_invoice

bash
curl -X POST https://bill.bestsmartgoods.com/v1/invoices/parse \
  -H "X-API-Key: ak_..." \
  -F "[email protected]"

Citation check

[mcptry]

Check whether a URL supports a claim. 0.08 credit per successful call.

MCP: https://cite.bestsmartgoods.com/mcp · tool check_citation

bash
curl -X POST https://cite.bestsmartgoods.com/v1/citations/check \
  -H "X-API-Key: ak_..." \
  -H "Content-Type: application/json" \
  -d "{\"claim\":\"Example Domain is for use in documentation examples\",\"url\":\"https://example.com\"}"

Prices

  • 100 credits = 5 EUR
  • 500 credits = 20 EUR
  • 2000 credits = 60 EUR

來源：README.md，提交 3b6e3d2

工具

1

lookup_operation

Read one API operation

Read one operation from a public OpenAPI or Swagger JSON document, or from a simple YAML document. Returns the method, path, operation id, summary, and required parameter and body fields. Send the document URL and a short intent, for example create a pet. The best text match is returned. A private address, a login wall, or a document with no matching operation is not charged. The first 5 successful reads each UTC day from one network address are free and need no key. After the 5, send X-API-Key. A key call costs 0.04 credit when an operation is returned. Do not send a URL on a private network. Key: https://firm.bestsmartgoods.com/signup

輸入參數url必填query必填

版本歷史

1
  1. v1.0.0最新Nov 5, 2026

評分

已滿足適用檢查項的 90%

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

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

    請在儲存庫或註冊中心條目中宣告授權條款。