{"openapi":"3.1.0","info":{"title":"Newstex MCP Network — x402 paid API","version":"1.0.0","description":"Pay-per-use access to licensed news via the x402 protocol (USDC on Base). Public and unauthenticated — a funded wallet is the only credential. Agent guide: https://static.newstex.com/llms.txt"},"servers":[{"url":"https://mcp.newstex.com"}],"paths":{"/x402/publications":{"get":{"summary":"FREE — list MCP-approved publications (returns the publication_id a paid search needs).","parameters":[{"name":"query","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Publication list (no payment required)."}}}},"/x402/search":{"get":{"summary":"Paid metadata-only story search within one MCP-approved publication.","parameters":[{"name":"publication_id","in":"query","required":true,"schema":{"type":"string"}},{"name":"q","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"}},{"name":"published_after","in":"query","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"published_before","in":"query","required":false,"schema":{"type":"string","format":"date-time"}}],"responses":{"200":{"description":"Paid result. The `PAYMENT-RESPONSE` header carries the settlement receipt (tx hash). A search that matches nothing still settles and is charged; `result_count` reports 0.","headers":{"PAYMENT-RESPONSE":{"description":"Base64 x402 settlement receipt.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment Required. The `PAYMENT-REQUIRED` response header carries the base64 x402 PaymentRequired envelope (scheme `exact`, USDC on Base). Sign it and retry the same request with the base64 signed payload in the `PAYMENT-SIGNATURE` request header (the legacy `X-PAYMENT` request header is also accepted for x402-v1 buyers).","headers":{"PAYMENT-REQUIRED":{"description":"Base64 x402 PaymentRequired envelope (accepts[] with amount/asset/payTo).","schema":{"type":"string"}}}}}}},"/x402/trending":{"get":{"summary":"Paid network-wide search across MCP-approved publications, newest first. `q` is optional (omit for the latest from everything).","parameters":[{"name":"publication_id","in":"query","required":false,"schema":{"type":"string"}},{"name":"q","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"}},{"name":"published_after","in":"query","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"published_before","in":"query","required":false,"schema":{"type":"string","format":"date-time"}}],"responses":{"200":{"description":"Paid result. The `PAYMENT-RESPONSE` header carries the settlement receipt (tx hash). A search that matches nothing still settles and is charged; `result_count` reports 0.","headers":{"PAYMENT-RESPONSE":{"description":"Base64 x402 settlement receipt.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment Required. The `PAYMENT-REQUIRED` response header carries the base64 x402 PaymentRequired envelope (scheme `exact`, USDC on Base). Sign it and retry the same request with the base64 signed payload in the `PAYMENT-SIGNATURE` request header (the legacy `X-PAYMENT` request header is also accepted for x402-v1 buyers).","headers":{"PAYMENT-REQUIRED":{"description":"Base64 x402 PaymentRequired envelope (accepts[] with amount/asset/payTo).","schema":{"type":"string"}}}}}}},"/x402/story":{"get":{"summary":"Paid retrieval of one full licensed story body.","parameters":[{"name":"story_id","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Paid result. The `PAYMENT-RESPONSE` header carries the settlement receipt (tx hash). A search that matches nothing still settles and is charged; `result_count` reports 0.","headers":{"PAYMENT-RESPONSE":{"description":"Base64 x402 settlement receipt.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment Required. The `PAYMENT-REQUIRED` response header carries the base64 x402 PaymentRequired envelope (scheme `exact`, USDC on Base). Sign it and retry the same request with the base64 signed payload in the `PAYMENT-SIGNATURE` request header (the legacy `X-PAYMENT` request header is also accepted for x402-v1 buyers).","headers":{"PAYMENT-REQUIRED":{"description":"Base64 x402 PaymentRequired envelope (accepts[] with amount/asset/payTo).","schema":{"type":"string"}}}}}}},"/x402/fact-check":{"get":{"summary":"Find licensed stories that support or contradict one factual claim, with why each matched. Not a verdict. DYNAMICALLY PRICED: free when no story supports or refutes the claim, otherwise a fixed per-check price. Nonsense, questions and restricted topics get a 400 with a `message` explaining why, and are never charged.","parameters":[{"name":"claim","in":"query","required":true,"schema":{"type":"string","maxLength":500}}],"responses":{"200":{"description":"Fact-check result: `{ status, claim, counts, supporting[], refuting[], disclaimer, price_usd }`. When `price_usd` is \"0.00\" nothing was quoted or settled and there is no `PAYMENT-RESPONSE` header; otherwise it is the settled paid result.","headers":{"PAYMENT-RESPONSE":{"description":"Base64 x402 settlement receipt.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Rejected claim; `message` says why. Never charged."},"402":{"description":"Payment Required. The `PAYMENT-REQUIRED` response header carries the base64 x402 PaymentRequired envelope (scheme `exact`, USDC on Base). Sign it and retry the same request with the base64 signed payload in the `PAYMENT-SIGNATURE` request header (the legacy `X-PAYMENT` request header is also accepted for x402-v1 buyers).","headers":{"PAYMENT-REQUIRED":{"description":"Base64 x402 PaymentRequired envelope (accepts[] with amount/asset/payTo).","schema":{"type":"string"}}}}}}},"/mcp/x402":{"post":{"summary":"MCP (Streamable HTTP) endpoint exposing the same paid tools (list_mcp_publications [free], search_paid_stories, search_trending_stories, get_paid_story, fact_check) with the x402 payment carried in _meta['x402/payment'].","responses":{"200":{"description":"MCP JSON-RPC response."}}}}}}