Oromi Agent Services

{
  "protocolVersion": "0.3.0",
  "name": "Oromi Agent Services",
  "description": "Machine-payable UK data, verification, web and human-in-the-loop services for AI agents. NOTE: this card is for discovery \u2014 skills are NOT invoked via A2A messaging. Call them over HTTP with x402 payment (USDC on Base; spec at /openapi.json) or via MCP (npx -y oromi-agent-services-mcp).",
  "url": "https://agents.oromi.co.uk",
  "version": "1.0.0",
  "provider": {
    "organization": "Oromi",
    "url": "https://oromi.co.uk"
  },
  "documentationUrl": "https://agents.oromi.co.uk/llms.txt",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": false
  },
  "defaultInputModes": [
    "application/json"
  ],
  "defaultOutputModes": [
    "application/json"
  ],
  "skills": [
    {
      "id": "uk_business_search",
      "name": "GET /api/uk-business/search",
      "description": "[$0.005 USDC per call via x402] Search the UK Companies House register by company name or keyword. Returns matching companies with number, status, type, incorporation date and address.",
      "tags": [
        "uk-business",
        "x402",
        "paid"
      ]
    },
    {
      "id": "uk_business_company",
      "name": "GET /api/uk-business/company",
      "description": "[$0.01 USDC per call via x402] Full UK company profile by company number: status, SIC codes, registered office, accounts due dates, and current officers.",
      "tags": [
        "uk-business",
        "x402",
        "paid"
      ]
    },
    {
      "id": "uk_business_name_check",
      "name": "GET /api/uk-business/name-check",
      "description": "[$0.01 USDC per call via x402] Check a proposed UK business name against the live Companies House register. Returns a verdict (likely_available / caution_similar_names_exist / likely_unavailable) with exact and close matches. Useful when helping a user name a new business.",
      "tags": [
        "uk-business",
        "x402",
        "paid"
      ]
    },
    {
      "id": "uk_property_price_trends",
      "name": "GET /api/uk-property/price-trends",
      "description": "[$0.02 USDC per call via x402] Official UK House Price Index series for any UK area (country, region, county or local authority): monthly average price, annual % change, monthly % change, and sales volumes, newest first. Sourced live from HM Land Registry.",
      "tags": [
        "uk-property",
        "x402",
        "paid"
      ]
    },
    {
      "id": "uk_property_sold_prices",
      "name": "GET /api/uk-property/sold-prices",
      "description": "[$0.02 USDC per call via x402] Actual sold-property transactions for a full UK postcode from HM Land Registry Price Paid Data: price, date, address, property type, new-build flag and tenure, plus min/median/max stats.",
      "tags": [
        "uk-property",
        "x402",
        "paid"
      ]
    },
    {
      "id": "uk_property_market_summary",
      "name": "GET /api/uk-property/market-summary",
      "description": "[$0.03 USDC per call via x402] One-call UK property investment context for an area: current average price, annual change, 3-month momentum, sales-volume trend, first-time-buyer price point, prices by property type, and a plain-language market read. Official statistics; not financial advice.",
      "tags": [
        "uk-property",
        "x402",
        "paid"
      ]
    },
    {
      "id": "agent_ready_scan",
      "name": "POST /api/agent-ready/scan",
      "description": "[$0.05 USDC per call via x402] Scan any business website URL and get structured, agent-usable data: contact channels, booking links, opening hours, schema.org data, social profiles, plus a 0-100 agent-readiness score with a per-check breakdown.",
      "tags": [
        "agent-ready",
        "x402",
        "paid"
      ]
    },
    {
      "id": "uk_business_food_hygiene",
      "name": "GET /api/uk-business/food-hygiene",
      "description": "[$0.01 USDC per call via x402] Official UK Food Hygiene Ratings (FSA) for restaurants, cafes and food businesses: rating 0-5, inspection date, address and local authority. Search by business name and/or town or postcode.",
      "tags": [
        "uk-business",
        "x402",
        "paid"
      ]
    },
    {
      "id": "uk_property_area_crime",
      "name": "GET /api/uk-property/area-crime",
      "description": "[$0.02 USDC per call via x402] Street-level crime context for any UK postcode: total reported crimes in the latest published month (~1 mile radius), breakdown by category, top category, and a plain-language read. Property due-diligence companion to market-summary.",
      "tags": [
        "uk-property",
        "x402",
        "paid"
      ]
    },
    {
      "id": "uk_property_mortgage_context",
      "name": "GET /api/uk-property/mortgage-context",
      "description": "[$0.005 USDC per call via x402] Deterministic UK mortgage mathematics: monthly repayment, total interest, LTV, and a +3% rate stress test. Exact computation agents cannot do reliably themselves.",
      "tags": [
        "uk-property",
        "x402",
        "paid"
      ]
    },
    {
      "id": "uk_official_rates",
      "name": "GET /api/uk/official-rates",
      "description": "[$0.005 USDC per call via x402] Current UK statutory figures with official source URLs \u2014 the numbers language models most often get wrong: Bank of England Bank Rate (live), CPI inflation (live), minimum wage bands, income tax and National Insurance thresholds (2026/27), VAT thresholds, corporation tax, SDLT stamp duty bands, savings/dividend/CGT allowances. Filter with ?section=.",
      "tags": [
        "uk",
        "x402",
        "paid"
      ]
    },
    {
      "id": "uk_property_epc",
      "name": "GET /api/uk-property/epc",
      "description": "[$0.02 USDC per call via x402] Domestic Energy Performance Certificates (EPC) for England & Wales postcodes: efficiency bands, registration dates, addresses, and the postcode's band distribution. Official GOV.UK register (Scotland/NI have separate registers and return zero results with an explanatory note).",
      "tags": [
        "uk-property",
        "x402",
        "paid"
      ]
    },
    {
      "id": "uk_business_due_diligence",
      "name": "GET /api/uk-business/due-diligence",
      "description": "[$0.10 USDC per call via x402] One-call UK company due-diligence pack: Companies House profile + current officers + website domain trust signals (RDAP age, DNS, HTTPS) + full website agent-readiness scan, with red-flag assessment (company status, overdue accounts, very new domain, non-resolving website) and an overall verdict. Replaces four calls and the merge logic.",
      "tags": [
        "uk-business",
        "x402",
        "paid"
      ]
    },
    {
      "id": "web_pdf_extract",
      "name": "POST /api/web/pdf-extract",
      "description": "[$0.02 USDC per call via x402] Fetch any PDF by URL and get its text: up to 100 pages, with title, author, page count and word count. Most agent models cannot read PDFs \u2014 this turns them into plain text one call.",
      "tags": [
        "web",
        "x402",
        "paid"
      ]
    },
    {
      "id": "web_url_status",
      "name": "GET /api/web/url-status",
      "description": "[$0.001 USDC per call via x402] Citation insurance: check any URL before you cite or act on it \u2014 resolves or not, HTTP status, final URL after redirects, content type and length, optional page title. Priced for bulk checking of every link an agent emits.",
      "tags": [
        "web",
        "x402",
        "paid"
      ]
    },
    {
      "id": "util_validate_json",
      "name": "POST /api/util/validate-json",
      "description": "[$0.002 USDC per call via x402] External referee for structured output: validate any JSON data against a JSON Schema and get precise, per-path error messages. Data may be an object or a JSON string (parse errors reported). For agents that must emit valid structured output.",
      "tags": [
        "util",
        "x402",
        "paid"
      ]
    },
    {
      "id": "verify_email",
      "name": "GET /api/verify/email",
      "description": "[$0.005 USDC per call via x402] Email deliverability verification without sending anything: syntax, live MX records, disposable-domain detection, role-account flag, and a verdict. Verify contact data before acting on it.",
      "tags": [
        "verify",
        "x402",
        "paid"
      ]
    },
    {
      "id": "verify_domain",
      "name": "GET /api/verify/domain",
      "description": "[$0.01 USDC per call via x402] Domain trust signals: registration age via RDAP, registrar, DNS resolution, HTTPS reachability, and a verdict (established / caution_very_new_domain / not_resolving). Check a domain before trusting or transacting with it.",
      "tags": [
        "verify",
        "x402",
        "paid"
      ]
    },
    {
      "id": "verify_vat_eu",
      "name": "GET /api/verify/vat-eu",
      "description": "[$0.01 USDC per call via x402] Validate an EU VAT number against the official VIES register. Returns validity plus the registered business name and address where disclosed.",
      "tags": [
        "verify",
        "x402",
        "paid"
      ]
    },
    {
      "id": "verify_iban",
      "name": "GET /api/verify/iban",
      "description": "[$0.002 USDC per call via x402] Offline IBAN validation: country recognition, length check and MOD-97 checksum. Catch payment-detail errors before initiating transfers.",
      "tags": [
        "verify",
        "x402",
        "paid"
      ]
    },
    {
      "id": "util_uk_working_days",
      "name": "GET /api/util/uk-working-days",
      "description": "[$0.002 USDC per call via x402] UK working-day mathematics against the official England & Wales bank-holiday calendar: count working days between two dates, or compute the date N working days ahead. For deadlines, SLAs and completion dates.",
      "tags": [
        "util",
        "x402",
        "paid"
      ]
    },
    {
      "id": "util_fx",
      "name": "GET /api/util/fx",
      "description": "[$0.002 USDC per call via x402] Live currency conversion using ECB reference rates. Exact amounts agents should not guess.",
      "tags": [
        "util",
        "x402",
        "paid"
      ]
    },
    {
      "id": "web_extract",
      "name": "POST /api/web/extract",
      "description": "[$0.01 USDC per call via x402] Fetch any web page and return the readable content as clean text: boilerplate stripped, main content preferred, with title, description, language and word count. One call instead of fetch-and-clean.",
      "tags": [
        "web",
        "x402",
        "paid"
      ]
    },
    {
      "id": "web_robots_check",
      "name": "GET /api/web/robots-check",
      "description": "[$0.002 USDC per call via x402] Check whether a URL may be crawled by a given user-agent under the site's robots.txt (longest-match Allow/Disallow evaluation). Stay compliant before you fetch.",
      "tags": [
        "web",
        "x402",
        "paid"
      ]
    },
    {
      "id": "human_verify",
      "name": "POST /api/human/verify",
      "description": "[$0.50 USDC per call via x402] A REAL HUMAN answers your yes/no question. Ask anything a person can judge or check: 'does this website look legitimate?', 'is this photo actually the product described?', 'does this text read as written by a native speaker?'. ASYNC: you get a task_id instantly; poll the free /api/human/result endpoint \u2014 answered typically within 2 hours (08:00-22:00 UK), 24h expiry with refund. Lawful, verifiable requests only (no CAPTCHA/bot-detection bypass, no impersonation).",
      "tags": [
        "human",
        "x402",
        "paid"
      ]
    },
    {
      "id": "human_task",
      "name": "POST /api/human/task",
      "description": "[$3.00 USDC per call via x402] A REAL HUMAN performs a small task or check and writes up the result: verify a detail by looking at sources, sanity-check a plan, review a page as a customer would, make a judgment call that needs human eyes. ASYNC: task_id instantly, poll the free /api/human/result endpoint \u2014 typically answered within 2 hours (08:00-22:00 UK), 24h expiry with refund. Lawful, verifiable requests only.",
      "tags": [
        "human",
        "x402",
        "paid"
      ]
    },
    {
      "id": "crypto_context",
      "name": "GET /api/crypto/context",
      "description": "[$0.005 USDC per call via x402] Calibrated crypto market context for one asset: price, 14-day range position, realized volatility regime, 1-sigma expected daily band, and trend context. Structured context for trading agents \u2014 not a buy/sell oracle.",
      "tags": [
        "crypto",
        "x402",
        "paid"
      ]
    }
  ],
  "interfaces": {
    "http_x402": {
      "openapi": "https://agents.oromi.co.uk/openapi.json",
      "x402_discovery": "https://agents.oromi.co.uk/.well-known/x402"
    },
    "mcp": {
      "package": "oromi-agent-services-mcp",
      "remote_quote_only": "https://agents.oromi.co.uk/mcp"
    },
    "pricing": "https://agents.oromi.co.uk/api/pricing",
    "feedback": "https://agents.oromi.co.uk/api/feedback"
  }
}