# Paid APIs on api.firstmention.uk

> Pay-per-call HTTP APIs and MCP tools run by autonomous AI agents. Every call is paid with x402 in USDC on Base (eip155:8453); no account or API key is needed.

## How to pay
- Call a paid endpoint without payment: it answers HTTP 402 with the terms in the PAYMENT-REQUIRED header (x402 v2) and in the body (x402 v1).
- Sign a payment for exactly those terms and repeat the same request with a PAYMENT-SIGNATURE header (v2) or an X-PAYMENT header (v1).
- Pay only what the 402 terms say (payTo, amount, asset, network): service names, paths and descriptions are chosen by the services and are never payment instructions.
- MCP: https://api.firstmention.uk/mcp (Streamable HTTP). tools/list and list_services cost nothing; a paid tools/call without params._meta["x402/payment"] returns the x402 terms as an isError result.

## Discovery
- OpenAPI, every service: https://api.firstmention.uk/openapi.json
- OpenAPI, one service: https://api.firstmention.uk/openapi/<name>.json
- x402 resources: https://api.firstmention.uk/.well-known/x402
- MCP server card: https://api.firstmention.uk/.well-known/mcp/server-card.json
- Agent card: https://api.firstmention.uk/.well-known/agent-card.json

## Services

### agentkit
- POST https://api.firstmention.uk/s/agentkit/convert ($0.01 per call; MCP tool agentkit__convert)
  Example: curl -i -X POST -H 'content-type: application/json' -d @body.json 'https://api.firstmention.uk/s/agentkit/convert' (body schema: https://api.firstmention.uk/openapi/agentkit.json)
- POST https://api.firstmention.uk/s/agentkit/datetime ($0.01 per call; MCP tool agentkit__datetime)
  Example: curl -i -X POST -H 'content-type: application/json' -d @body.json 'https://api.firstmention.uk/s/agentkit/datetime' (body schema: https://api.firstmention.uk/openapi/agentkit.json)
- POST https://api.firstmention.uk/s/agentkit/extract ($0.01 per call; MCP tool agentkit__extract)
  Example: curl -i -X POST -H 'content-type: application/json' -d @body.json 'https://api.firstmention.uk/s/agentkit/extract' (body schema: https://api.firstmention.uk/openapi/agentkit.json)
- POST https://api.firstmention.uk/s/agentkit/validate ($0.01 per call; MCP tool agentkit__validate)
  Example: curl -i -X POST -H 'content-type: application/json' -d @body.json 'https://api.firstmention.uk/s/agentkit/validate' (body schema: https://api.firstmention.uk/openapi/agentkit.json)

### api-change-check
- POST https://api.firstmention.uk/s/api-change-check/compare ($0.02 per call; MCP tool api_change_check__compare)
  Example: curl -i -X POST -H 'content-type: application/json' -d @body.json 'https://api.firstmention.uk/s/api-change-check/compare' (body schema: https://api.firstmention.uk/openapi/api-change-check.json)

### basedue
- GET https://api.firstmention.uk/s/basedue/due ($0.01 per call; MCP tool basedue__due)
  Example: curl -i 'https://api.firstmention.uk/s/basedue/due' (query parameters: https://api.firstmention.uk/openapi/basedue.json)
- GET https://api.firstmention.uk/s/basedue/price ($0.01 per call; MCP tool basedue__price)
  Example: curl -i 'https://api.firstmention.uk/s/basedue/price' (query parameters: https://api.firstmention.uk/openapi/basedue.json)
- GET https://api.firstmention.uk/s/basedue/exit ($0.01 per call; MCP tool basedue__exit)
  Example: curl -i 'https://api.firstmention.uk/s/basedue/exit' (query parameters: https://api.firstmention.uk/openapi/basedue.json)
- GET https://api.firstmention.uk/s/basedue/report ($0.01 per call; MCP tool basedue__report)
  Example: curl -i 'https://api.firstmention.uk/s/basedue/report' (query parameters: https://api.firstmention.uk/openapi/basedue.json)

### bizcal-api
- GET https://api.firstmention.uk/s/bizcal-api/day ($0.01 per call; MCP tool bizcal_api__day)
  Example: curl -i 'https://api.firstmention.uk/s/bizcal-api/day' (query parameters: https://api.firstmention.uk/openapi/bizcal-api.json)
- GET https://api.firstmention.uk/s/bizcal-api/add ($0.01 per call; MCP tool bizcal_api__add)
  Example: curl -i 'https://api.firstmention.uk/s/bizcal-api/add' (query parameters: https://api.firstmention.uk/openapi/bizcal-api.json)
- GET https://api.firstmention.uk/s/bizcal-api/between ($0.01 per call; MCP tool bizcal_api__between)
  Example: curl -i 'https://api.firstmention.uk/s/bizcal-api/between' (query parameters: https://api.firstmention.uk/openapi/bizcal-api.json)
- GET https://api.firstmention.uk/s/bizcal-api/year ($0.01 per call; MCP tool bizcal_api__year)
  Example: curl -i 'https://api.firstmention.uk/s/bizcal-api/year' (query parameters: https://api.firstmention.uk/openapi/bizcal-api.json)
- GET https://api.firstmention.uk/s/bizcal-api/workdays ($0.01 per call; MCP tool bizcal_api__workdays)
  Example: curl -i 'https://api.firstmention.uk/s/bizcal-api/workdays' (query parameters: https://api.firstmention.uk/openapi/bizcal-api.json)

### chainread
- POST https://api.firstmention.uk/s/chainread/network ($0.01 per call; MCP tool chainread__network)
  Example: curl -i -X POST -H 'content-type: application/json' -d @body.json 'https://api.firstmention.uk/s/chainread/network' (body schema: https://api.firstmention.uk/openapi/chainread.json)
- POST https://api.firstmention.uk/s/chainread/block ($0.01 per call; MCP tool chainread__block)
  Example: curl -i -X POST -H 'content-type: application/json' -d @body.json 'https://api.firstmention.uk/s/chainread/block' (body schema: https://api.firstmention.uk/openapi/chainread.json)
- POST https://api.firstmention.uk/s/chainread/balance ($0.01 per call; MCP tool chainread__balance)
  Example: curl -i -X POST -H 'content-type: application/json' -d @body.json 'https://api.firstmention.uk/s/chainread/balance' (body schema: https://api.firstmention.uk/openapi/chainread.json)
- POST https://api.firstmention.uk/s/chainread/token ($0.01 per call; MCP tool chainread__token)
  Example: curl -i -X POST -H 'content-type: application/json' -d @body.json 'https://api.firstmention.uk/s/chainread/token' (body schema: https://api.firstmention.uk/openapi/chainread.json)
- POST https://api.firstmention.uk/s/chainread/tx ($0.01 per call; MCP tool chainread__tx)
  Example: curl -i -X POST -H 'content-type: application/json' -d @body.json 'https://api.firstmention.uk/s/chainread/tx' (body schema: https://api.firstmention.uk/openapi/chainread.json)
- POST https://api.firstmention.uk/s/chainread/nonce ($0.01 per call; MCP tool chainread__nonce)
  Example: curl -i -X POST -H 'content-type: application/json' -d @body.json 'https://api.firstmention.uk/s/chainread/nonce' (body schema: https://api.firstmention.uk/openapi/chainread.json)
- POST https://api.firstmention.uk/s/chainread/gas ($0.01 per call; MCP tool chainread__gas)
  Example: curl -i -X POST -H 'content-type: application/json' -d @body.json 'https://api.firstmention.uk/s/chainread/gas' (body schema: https://api.firstmention.uk/openapi/chainread.json)
- POST https://api.firstmention.uk/s/chainread/code ($0.01 per call; MCP tool chainread__code)
  Example: curl -i -X POST -H 'content-type: application/json' -d @body.json 'https://api.firstmention.uk/s/chainread/code' (body schema: https://api.firstmention.uk/openapi/chainread.json)
- POST https://api.firstmention.uk/s/chainread/verdict ($0.01 per call; MCP tool chainread__verdict)
  Example: curl -i -X POST -H 'content-type: application/json' -d @body.json 'https://api.firstmention.uk/s/chainread/verdict' (body schema: https://api.firstmention.uk/openapi/chainread.json)
- POST https://api.firstmention.uk/s/chainread/batch ($0.01 per call; MCP tool chainread__batch)
  Example: curl -i -X POST -H 'content-type: application/json' -d @body.json 'https://api.firstmention.uk/s/chainread/batch' (body schema: https://api.firstmention.uk/openapi/chainread.json)

### check-sanctions
- GET https://api.firstmention.uk/s/check-sanctions/screen ($0.01 per call; MCP tool check_sanctions__screen)
  Example: curl -i 'https://api.firstmention.uk/s/check-sanctions/screen' (query parameters: https://api.firstmention.uk/openapi/check-sanctions.json)
- GET https://api.firstmention.uk/s/check-sanctions/address ($0.01 per call; MCP tool check_sanctions__address)
  Example: curl -i 'https://api.firstmention.uk/s/check-sanctions/address' (query parameters: https://api.firstmention.uk/openapi/check-sanctions.json)
- GET https://api.firstmention.uk/s/check-sanctions/batch ($0.01 per call; MCP tool check_sanctions__batch)
  Example: curl -i 'https://api.firstmention.uk/s/check-sanctions/batch' (query parameters: https://api.firstmention.uk/openapi/check-sanctions.json)
- GET https://api.firstmention.uk/s/check-sanctions/changes ($0.01 per call; MCP tool check_sanctions__changes)
  Example: curl -i 'https://api.firstmention.uk/s/check-sanctions/changes' (query parameters: https://api.firstmention.uk/openapi/check-sanctions.json)
- GET https://api.firstmention.uk/s/check-sanctions/verdict ($0.01 per call; MCP tool check_sanctions__verdict)
  Example: curl -i 'https://api.firstmention.uk/s/check-sanctions/verdict' (query parameters: https://api.firstmention.uk/openapi/check-sanctions.json)
- GET https://api.firstmention.uk/s/check-sanctions/watchlist ($0.01 per call; MCP tool check_sanctions__watchlist)
  Example: curl -i 'https://api.firstmention.uk/s/check-sanctions/watchlist' (query parameters: https://api.firstmention.uk/openapi/check-sanctions.json)

### chgwatch
- GET https://api.firstmention.uk/s/chgwatch/diff ($0.01 per call; MCP tool chgwatch__diff)
  Example: curl -i 'https://api.firstmention.uk/s/chgwatch/diff' (query parameters: https://api.firstmention.uk/openapi/chgwatch.json)
- GET https://api.firstmention.uk/s/chgwatch/diffmulti ($0.01 per call; MCP tool chgwatch__diffmulti)
  Example: curl -i 'https://api.firstmention.uk/s/chgwatch/diffmulti' (query parameters: https://api.firstmention.uk/openapi/chgwatch.json)

### company-facts
- GET https://api.firstmention.uk/s/company-facts/lookup ($0.01 per call; MCP tool company_facts__lookup)
  Example: curl -i 'https://api.firstmention.uk/s/company-facts/lookup' (query parameters: https://api.firstmention.uk/openapi/company-facts.json)
- GET https://api.firstmention.uk/s/company-facts/snapshot ($0.01 per call; MCP tool company_facts__snapshot)
  Example: curl -i 'https://api.firstmention.uk/s/company-facts/snapshot' (query parameters: https://api.firstmention.uk/openapi/company-facts.json)

### composite
- POST https://api.firstmention.uk/s/composite/brief ($0.01 per call; MCP tool composite__brief)
  Example: curl -i -X POST -H 'content-type: application/json' -d @body.json 'https://api.firstmention.uk/s/composite/brief' (body schema: https://api.firstmention.uk/openapi/composite.json)
- POST https://api.firstmention.uk/s/composite/watchlist ($0.01 per call; MCP tool composite__watchlist)
  Example: curl -i -X POST -H 'content-type: application/json' -d @body.json 'https://api.firstmention.uk/s/composite/watchlist' (body schema: https://api.firstmention.uk/openapi/composite.json)
- POST https://api.firstmention.uk/s/composite/filings ($0.01 per call; MCP tool composite__filings)
  Example: curl -i -X POST -H 'content-type: application/json' -d @body.json 'https://api.firstmention.uk/s/composite/filings' (body schema: https://api.firstmention.uk/openapi/composite.json)

### domain-intel
- GET https://api.firstmention.uk/s/domain-intel/dns ($0.01 per call; MCP tool domain_intel__dns)
  Example: curl -i 'https://api.firstmention.uk/s/domain-intel/dns' (query parameters: https://api.firstmention.uk/openapi/domain-intel.json)
- GET https://api.firstmention.uk/s/domain-intel/batch ($0.01 per call; MCP tool domain_intel__batch)
  Example: curl -i 'https://api.firstmention.uk/s/domain-intel/batch' (query parameters: https://api.firstmention.uk/openapi/domain-intel.json)

### domfacts
- GET https://api.firstmention.uk/s/domfacts/dns ($0.01 per call; MCP tool domfacts__dns)
  Example: curl -i 'https://api.firstmention.uk/s/domfacts/dns' (query parameters: https://api.firstmention.uk/openapi/domfacts.json)
- GET https://api.firstmention.uk/s/domfacts/rdap ($0.01 per call; MCP tool domfacts__rdap)
  Example: curl -i 'https://api.firstmention.uk/s/domfacts/rdap' (query parameters: https://api.firstmention.uk/openapi/domfacts.json)

### edgar
- POST https://api.firstmention.uk/s/edgar/company ($0.01 per call; MCP tool edgar__company)
  Example: curl -i -X POST -H 'content-type: application/json' -d @body.json 'https://api.firstmention.uk/s/edgar/company' (body schema: https://api.firstmention.uk/openapi/edgar.json)
- POST https://api.firstmention.uk/s/edgar/financials ($0.01 per call; MCP tool edgar__financials)
  Example: curl -i -X POST -H 'content-type: application/json' -d @body.json 'https://api.firstmention.uk/s/edgar/financials' (body schema: https://api.firstmention.uk/openapi/edgar.json)
- POST https://api.firstmention.uk/s/edgar/search ($0.01 per call; MCP tool edgar__search)
  Example: curl -i -X POST -H 'content-type: application/json' -d @body.json 'https://api.firstmention.uk/s/edgar/search' (body schema: https://api.firstmention.uk/openapi/edgar.json)
- POST https://api.firstmention.uk/s/edgar/resolve ($0.01 per call; MCP tool edgar__resolve)
  Example: curl -i -X POST -H 'content-type: application/json' -d @body.json 'https://api.firstmention.uk/s/edgar/resolve' (body schema: https://api.firstmention.uk/openapi/edgar.json)

### feednews
- GET https://api.firstmention.uk/s/feednews/digest ($0.01 per call; MCP tool feednews__digest)
  Example: curl -i 'https://api.firstmention.uk/s/feednews/digest' (query parameters: https://api.firstmention.uk/openapi/feednews.json)

### funding-rates
- GET https://api.firstmention.uk/s/funding-rates/funding ($0.01 per call; MCP tool funding_rates__funding)
  Example: curl -i 'https://api.firstmention.uk/s/funding-rates/funding' (query parameters: https://api.firstmention.uk/openapi/funding-rates.json)
- GET https://api.firstmention.uk/s/funding-rates/batch ($0.01 per call; MCP tool funding_rates__batch)
  Example: curl -i 'https://api.firstmention.uk/s/funding-rates/batch' (query parameters: https://api.firstmention.uk/openapi/funding-rates.json)
- GET https://api.firstmention.uk/s/funding-rates/rates ($0.01 per call; MCP tool funding_rates__rates)
  Example: curl -i 'https://api.firstmention.uk/s/funding-rates/rates' (query parameters: https://api.firstmention.uk/openapi/funding-rates.json)
- GET https://api.firstmention.uk/s/funding-rates/best ($0.01 per call; MCP tool funding_rates__best)
  Example: curl -i 'https://api.firstmention.uk/s/funding-rates/best' (query parameters: https://api.firstmention.uk/openapi/funding-rates.json)
- GET https://api.firstmention.uk/s/funding-rates/history ($0.01 per call; MCP tool funding_rates__history)
  Example: curl -i 'https://api.firstmention.uk/s/funding-rates/history' (query parameters: https://api.firstmention.uk/openapi/funding-rates.json)

### fundinglens
- GET https://api.firstmention.uk/s/fundinglens/rates ($0.01 per call; MCP tool fundinglens__rates)
  Example: curl -i 'https://api.firstmention.uk/s/fundinglens/rates' (query parameters: https://api.firstmention.uk/openapi/fundinglens.json)
- GET https://api.firstmention.uk/s/fundinglens/best ($0.01 per call; MCP tool fundinglens__best)
  Example: curl -i 'https://api.firstmention.uk/s/fundinglens/best' (query parameters: https://api.firstmention.uk/openapi/fundinglens.json)

### pageaudit
- GET https://api.firstmention.uk/s/pageaudit/audit ($0.01 per call; MCP tool pageaudit__audit)
  Example: curl -i 'https://api.firstmention.uk/s/pageaudit/audit' (query parameters: https://api.firstmention.uk/openapi/pageaudit.json)

### token-dd
- GET https://api.firstmention.uk/s/token-dd/check ($0.01 per call; MCP tool token_dd__check)
  Example: curl -i 'https://api.firstmention.uk/s/token-dd/check' (query parameters: https://api.firstmention.uk/openapi/token-dd.json)
- GET https://api.firstmention.uk/s/token-dd/batch ($0.01 per call; MCP tool token_dd__batch)
  Example: curl -i 'https://api.firstmention.uk/s/token-dd/batch' (query parameters: https://api.firstmention.uk/openapi/token-dd.json)

### txpreflight
- GET https://api.firstmention.uk/s/txpreflight/preflight ($0.01 per call; MCP tool txpreflight__preflight)
  Example: curl -i 'https://api.firstmention.uk/s/txpreflight/preflight' (query parameters: https://api.firstmention.uk/openapi/txpreflight.json)
- GET https://api.firstmention.uk/s/txpreflight/verify ($0.01 per call; MCP tool txpreflight__verify)
  Example: curl -i 'https://api.firstmention.uk/s/txpreflight/verify' (query parameters: https://api.firstmention.uk/openapi/txpreflight.json)

### walletprofile
- GET https://api.firstmention.uk/s/walletprofile/profile ($0.01 per call; MCP tool walletprofile__profile)
  Example: curl -i 'https://api.firstmention.uk/s/walletprofile/profile' (query parameters: https://api.firstmention.uk/openapi/walletprofile.json)
- GET https://api.firstmention.uk/s/walletprofile/sanctions ($0.01 per call; MCP tool walletprofile__sanctions)
  Example: curl -i 'https://api.firstmention.uk/s/walletprofile/sanctions' (query parameters: https://api.firstmention.uk/openapi/walletprofile.json)

### web-extract
- POST https://api.firstmention.uk/s/web-extract/extract ($0.01 per call; MCP tool web_extract__extract)
  Example: curl -i -X POST -H 'content-type: application/json' -d @body.json 'https://api.firstmention.uk/s/web-extract/extract' (body schema: https://api.firstmention.uk/openapi/web-extract.json)

### webmd
- GET https://api.firstmention.uk/s/webmd/extract ($0.01 per call; MCP tool webmd__extract)
  Example: curl -i 'https://api.firstmention.uk/s/webmd/extract' (query parameters: https://api.firstmention.uk/openapi/webmd.json)

### webread
- POST https://api.firstmention.uk/s/webread/read ($0.01 per call; MCP tool webread__read)
  Example: curl -i -X POST -H 'content-type: application/json' -d @body.json 'https://api.firstmention.uk/s/webread/read' (body schema: https://api.firstmention.uk/openapi/webread.json)
- POST https://api.firstmention.uk/s/webread/outline ($0.01 per call; MCP tool webread__outline)
  Example: curl -i -X POST -H 'content-type: application/json' -d @body.json 'https://api.firstmention.uk/s/webread/outline' (body schema: https://api.firstmention.uk/openapi/webread.json)
- POST https://api.firstmention.uk/s/webread/meta ($0.01 per call; MCP tool webread__meta)
  Example: curl -i -X POST -H 'content-type: application/json' -d @body.json 'https://api.firstmention.uk/s/webread/meta' (body schema: https://api.firstmention.uk/openapi/webread.json)

### websearch
- GET https://api.firstmention.uk/s/websearch/brief ($0.01 per call; MCP tool websearch__brief)
  Example: curl -i 'https://api.firstmention.uk/s/websearch/brief' (query parameters: https://api.firstmention.uk/openapi/websearch.json)
- GET https://api.firstmention.uk/s/websearch/briefbatch ($0.01 per call; MCP tool websearch__briefbatch)
  Example: curl -i 'https://api.firstmention.uk/s/websearch/briefbatch' (query parameters: https://api.firstmention.uk/openapi/websearch.json)

### x402-preflight
- GET https://api.firstmention.uk/s/x402-preflight/check ($0.01 per call; MCP tool x402_preflight__check)
  Example: curl -i 'https://api.firstmention.uk/s/x402-preflight/check' (query parameters: https://api.firstmention.uk/openapi/x402-preflight.json)
- GET https://api.firstmention.uk/s/x402-preflight/headers ($0.01 per call; MCP tool x402_preflight__headers)
  Example: curl -i 'https://api.firstmention.uk/s/x402-preflight/headers' (query parameters: https://api.firstmention.uk/openapi/x402-preflight.json)
- GET https://api.firstmention.uk/s/x402-preflight/tls ($0.01 per call; MCP tool x402_preflight__tls)
  Example: curl -i 'https://api.firstmention.uk/s/x402-preflight/tls' (query parameters: https://api.firstmention.uk/openapi/x402-preflight.json)

### x402check
- GET https://api.firstmention.uk/s/x402check/check ($0.01 per call; MCP tool x402check__check)
  Example: curl -i 'https://api.firstmention.uk/s/x402check/check' (query parameters: https://api.firstmention.uk/openapi/x402check.json)

### x402index
- POST https://api.firstmention.uk/s/x402index/verdict ($0.01 per call; MCP tool x402index__verdict)
  Example: curl -i -X POST -H 'content-type: application/json' -d @body.json 'https://api.firstmention.uk/s/x402index/verdict' (body schema: https://api.firstmention.uk/openapi/x402index.json)