generated: '2026-09-19'
method: derived
source: >-
  Derived by aligning the LIVE tools/list of https://network.mercury-hq.com/mcp (18 tools, fetched
  unauthenticated 2026-09-19, saved as mcp/mercury-hq-com-mcp-tools-list.json) with
  openapi/mercury-hq-com-x402-storefront-openapi.yml (19 operations). Both are generated by the provider
  from one catalog object (stated on /trust and /university/docs), and the tool inputSchema property sets
  were compared field-by-field with the operation query parameters.
purpose: >-
  Bind each MCP tool to the REST operation that backs it so the tool inherits the operation's real
  parameter contract and price. For MERCURY the two surfaces are the same 18 paid SKUs projected twice;
  the only divergences are the free demo read (REST only) and the two free helper tools the stdio
  package adds (package only).
surfaces:
  rest_openapi: openapi/mercury-hq-com-x402-storefront-openapi.yml   # 19 GET operations; unpaid calls answer 402 x402 challenge; source in openapi/_original/
  graphql: none
  mcp: https://network.mercury-hq.com/mcp                             # tools/list FREE (not gated); tools/call gated by Bearer mk_ API key
  mcp_stdio: npx -y mercury-x402-mcp                                  # same catalog, pays over x402 from a wallet key
crosswalk:
- {tool: fetch, category: fetch, rest: [buy_web_fetch], binding: rest, confidence: high, note: 'identical properties url/format/links/extract; identical maxLength and enum values'}
- {tool: extract, category: extract, rest: [buy_extract], binding: rest, confidence: high, note: 'identical properties url/schema/format'}
- {tool: markdown, category: fetch, rest: [buy_cited_markdown], binding: rest, confidence: high}
- {tool: metadata, category: extract, rest: [buy_cited_metadata], binding: rest, confidence: high}
- {tool: links, category: extract, rest: [buy_cited_links], binding: rest, confidence: high}
- {tool: robots, category: crawl, rest: [buy_cited_robots], binding: rest, confidence: high, note: 'identical properties domain/path'}
- {tool: diff, category: verify, rest: [buy_cited_diff], binding: rest, confidence: high, note: 'identical properties url/prevHash/prevText/format'}
- {tool: notarize, category: verify, rest: [buy_cited_notarize], binding: rest, confidence: high, note: 'identical properties url/content (either one)'}
- {tool: headers, category: monitor, rest: [buy_cited_headers], binding: rest, confidence: high}
- {tool: table, category: extract, rest: [buy_cited_table], binding: rest, confidence: high, note: 'identical properties url/table/format'}
- {tool: feed, category: extract, rest: [buy_cited_feed], binding: rest, confidence: high}
- {tool: availability, category: monitor, rest: [buy_cited_availability], binding: rest, confidence: high}
- {tool: validate, category: verify, rest: [buy_cited_validate], binding: rest, confidence: high, note: 'identical properties url/schema/pointer'}
- {tool: batch, category: fetch, rest: [buy_cited_batch], binding: rest, confidence: high, note: 'identical properties urls/format'}
- {tool: sitemap, category: crawl, rest: [buy_cited_sitemap], binding: rest, confidence: high, note: 'identical properties url/fetch/limit'}
- {tool: dns, category: domain, rest: [buy_cited_dns], binding: rest, confidence: high, note: 'identical properties domain/url (either one)'}
- {tool: readability, category: fetch, rest: [buy_cited_readability], binding: rest, confidence: high}
- {tool: redirect, category: monitor, rest: [buy_cited_redirect], binding: rest, confidence: high}
mcp_only:
- {tool: mercury_catalog, reason: 'free helper in the stdio package (npm README) that returns /catalog; the hosted server does not list it and REST exposes the catalog as a plain GET /catalog outside the OpenAPI'}
- {tool: mercury_verify, reason: 'free helper in the stdio package (npm README) wrapping the receipt verifier (POST /verify, GET /x402/verify), which is not in the OpenAPI'}
rest_only:
- capability: free demo read
  operations: [buy_signal]
  reason: GET /buy/signal ($0, sample data) has no tool on the hosted server
coverage:
  mcp_tools_named: 18
  mcp_tools_bound_to_rest: 18
  mcp_only: 0                      # hosted server; +2 free helpers in the stdio package
  rest_operations_total: 19
  rest_operations_with_tool: 18
  graphql_fields: 0