Oromi Agent Services

Oromi Agent Services — MCP 服务

将 agents.oromi.co.uk 上全部 25 个按次付费工具 直接接入任何支持 MCP 的模型（Claude Desktop、Claude Code、Cursor 以及大多数 Agent 框架）。工具在启动时根据实时的 /openapi.json 生成，因此新端点会自动出现——这个软件包永远不会过时。

两种模式：

• 报价模式（无需钱包）： 工具会返回价格以及如何启用 付款。默认安全模式；方便用户浏览目录。
• 付费模式： 设置 BUYER_PRIVATE_KEY，使用一个持有少量 Base 上 USDC 的 EVM 钱包密钥——通过 x402 自动为调用付款（买家无需支付 Gas）。

使用方法（发布到 npm 后）

Claude Desktop → Settings → Developer → Edit Config，添加：

{
  "mcpServers": {
    "oromi": {
      "command": "npx",
      "args": ["-y", "oromi-agent-services-mcp"],
      "env": { "BUYER_PRIVATE_KEY": "0x..." }
    }
  }
}

Claude Code：claude mcp add oromi -e BUYER_PRIVATE_KEY=0x... -- npx -y oromi-agent-services-mcp

报价模式下可完全省略环境变量。OROMI_ORIGIN 可覆盖 API 源站（用于本地开发）。

工具

• oromi_catalog — 免费：列出所有端点及其价格、网络和说明
• oromi_feedback — 免费：提交你希望增加的数据或端点（由真人阅读，并确实据此构建）
• uk_business_search — $0.005 · 按名称或关键词搜索英国 Companies House 注册信息
• uk_business_company — $0.01 · 完整公司资料：状态、SIC 代码、注册办公地址、主管人员
• uk_business_name_check — $0.01 · 根据实时注册信息判断企业名称是否可用
• uk_business_food_hygiene — $0.01 · 查询英国任意食品企业的官方 FSA 食品卫生评级
• uk_business_due_diligence — $0.10 · 综合查询：公司、主管人员、域名信任度、网站扫描及风险标记评估
• uk_official_rates — $0.005 · 当前英国法定数据：基准利率（实时）、CPI、最低工资、税收/NI 门槛、VAT、SDLT 税率区间——附官方来源 URL
• uk_property_price_trends — $0.02 · 查询英国任意地区的房价指数历史记录（HM Land Registry）
• uk_property_sold_prices — $0.02 · 按邮政编码查询实际房产成交记录（Price Paid Data）
• uk_property_market_summary — $0.03 · 一次调用获取地区投资背景：价格、走势、成交量趋势
• uk_property_area_crime — $0.02 · 查询英国任意邮政编码区域的街道级犯罪情况
• uk_property_mortgage_context — $0.005 · 精确计算按揭还款额 + 利率压力测试
• uk_property_epc — $0.02 · 按邮政编码查询能源性能证书（英格兰和威尔士注册信息）
• verify_email — $0.005 · 邮件可送达性检查：语法、MX 记录、一次性域名检测
• verify_domain — $0.01 · 域名信任信号：注册时长（RDAP）、DNS、HTTPS
• verify_vat_eu — $0.01 · 官方 EU VIES VAT 编号验证
• verify_iban — $0.002 · 离线验证 IBAN 结构和校验和
• util_uk_working_days — $0.002 · 根据英国官方银行假日日历计算工作日
• util_fx — $0.002 · 按 ECB 参考汇率进行货币换算
• util_validate_json — $0.002 · 根据 JSON Schema 验证 JSON 数据，并提供精确错误信息
• web_extract — $0.01 · 任意网页 → 清晰易读的文本
• web_pdf_extract — $0.02 · 任意 PDF URL → 文本（大多数 Agent 模型无法读取 PDF）
• web_url_status — $0.001 · 引用保障：检查 URL 是否可访问，以及它会重定向到哪里
• web_robots_check — $0.002 · 检查任意 URL 和 user-agent 的 robots.txt 爬取许可
• agent_ready_scan — $0.05 · 网站 → 结构化、可供 Agent 使用的数据 + 0–100 的 Agent 就绪度评分
• crypto_context — $0.005 · 加密货币市场背景：价格、波动状态、区间位置

发布到 npm（一次性，约 10 分钟）

1. 在 npmjs.com 创建 npm 账号（免费）并验证邮箱。
2. 在此文件夹中运行：npm login（会打开浏览器），然后：

   npm publish --access public
   

3. 后续更新：提升 package.json 中的 version，然后再次运行 npm publish。

在官方 MCP 注册表中上架（约 15 分钟）

MCP 客户端和目录会搜索 registry.modelcontextprotocol.io 上的注册表。发布需要使用 mcp-publisher CLI 并通过 GitHub 身份验证（此文件夹中的 server.json 是清单——如果你的 GitHub 用户名与 oromi-uk 不同，请更新 name）：

npm install -g @modelcontextprotocol/publisher   # or download mcp-publisher from
                                                 # github.com/modelcontextprotocol/registry releases
mcp-publisher login github
mcp-publisher publish

如果你运行时 CLI 名称或安装方式有所不同，请查看 github.com/modelcontextprotocol/registry 上的最新说明——这里的清单格式无论如何都是正确的。

本地测试

OROMI_ORIGIN=http://localhost:3000 node src/index.js
# then type a JSON-RPC initialize message, or just add it to Claude Desktop with
# "command": "node", "args": ["C:/path/to/mcp/src/index.js"]