oromi-agent-services-mcp

Oromi Agent Services — MCP Server

Puts all 25 agents.oromi.co.uk pay-per-call tools directly into any MCP-capable model (Claude Desktop, Claude Code, Cursor, most agent frameworks). Tools are generated at startup from the live /openapi.json, so new endpoints appear automatically — this package never goes stale.

Two modes:

• Quote mode (no wallet): tools respond with the price and how to enable payment. Safe default; lets users browse the catalog.
• Paid mode: set BUYER_PRIVATE_KEY to an EVM key whose wallet holds a few USDC on Base — calls are paid automatically via x402 (gasless for the buyer).

Use it (once published to npm)

Claude Desktop → Settings → Developer → Edit Config, add:

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

Omit the env entirely for quote mode. OROMI_ORIGIN overrides the API origin (for local dev).

Tools

• oromi_catalog — FREE: list every endpoint with price, network and description
• oromi_feedback — FREE: request data or endpoints you wish existed (human-read, genuinely built)
• uk_business_search — $0.005 · Search the UK Companies House register by name or keyword
• uk_business_company — $0.01 · Full company profile: status, SIC codes, registered office, officers
• uk_business_name_check — $0.01 · Business-name availability verdict against the live register
• uk_business_food_hygiene — $0.01 · Official FSA food hygiene ratings for any UK food business
• uk_business_due_diligence — $0.10 · Composite: company + officers + domain trust + website scan with red-flag assessment
• uk_official_rates — $0.005 · Current UK statutory figures: Bank Rate (live), CPI, minimum wage, tax/NI thresholds, VAT, SDLT bands — with official source URLs
• uk_property_price_trends — $0.02 · House Price Index history for any UK area (HM Land Registry)
• uk_property_sold_prices — $0.02 · Actual sold-property transactions by postcode (Price Paid Data)
• uk_property_market_summary — $0.03 · One-call area investment context: prices, momentum, volume trend
• uk_property_area_crime — $0.02 · Street-level crime context for any UK postcode
• uk_property_mortgage_context — $0.005 · Exact mortgage repayment maths + rate stress test
• uk_property_epc — $0.02 · Energy Performance Certificates by postcode (England & Wales register)
• verify_email — $0.005 · Deliverability checks: syntax, MX records, disposable-domain detection
• verify_domain — $0.01 · Domain trust signals: registration age (RDAP), DNS, HTTPS
• verify_vat_eu — $0.01 · Official EU VIES VAT number validation
• verify_iban — $0.002 · Offline IBAN structure and checksum validation
• util_uk_working_days — $0.002 · Working-day maths against the official UK bank-holiday calendar
• util_fx — $0.002 · Currency conversion at ECB reference rates
• util_validate_json — $0.002 · Validate JSON data against a JSON Schema with precise errors
• web_extract — $0.01 · Any web page → clean readable text
• web_pdf_extract — $0.02 · Any PDF URL → text (most agent models cannot read PDFs)
• web_url_status — $0.001 · Citation insurance: does this URL resolve, where does it redirect
• web_robots_check — $0.002 · robots.txt crawl-permission check for any URL + user-agent
• agent_ready_scan — $0.05 · Website → structured agent-usable data + 0–100 agent-readiness score
• crypto_context — $0.005 · Crypto market context: price, volatility regime, range position

Publish to npm (one time, ~10 min)

• Create an npm account at npmjs.com (free) and verify the email.
• In this folder: npm login (opens browser), then:

  npm publish --access public
  

• Future updates: bump version in package.json, npm publish again.

List in the official MCP Registry (~15 min)

The registry at registry.modelcontextprotocol.io is what MCP clients and directories search. Publishing requires the mcp-publisher CLI and GitHub auth (the server.json in this folder is the manifest — update the GitHub username in name if yours differs from oromi-uk):

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

If the CLI name/install differs when you run this, the current instructions live at github.com/modelcontextprotocol/registry — the manifest format here is correct either way.

Local test

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"]