# Newstex Story Search (Metadata)

> Newstex Story Search (Metadata) is a paid API for AI agents from mcp.newstex.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-17).

Searches the Newstex licensed content network and returns a paginated page of metadata-only story results for a given publication.

## Facts

- Endpoint: GET https://mcp.newstex.com/x402/search?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/newstex-story-search-metadata-f2e7373e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_P_8WRmXeCKvc1suM6iR1Z

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability newstex-story-search-metadata-f2e7373e
```

Example prompt: Search the Newstex publication 'pub_abc123' for stories about artificial intelligence and return the first 10 results — just the metadata, not the full text.

## When to prefer this

Use this endpoint when you need to discover and browse news stories within a specific Newstex-licensed publication by keyword, without incurring the higher cost of fetching full story bodies. Prefer this over the full story retrieval endpoint when you need to scan headlines, filter results, or identify which articles are relevant before committing to fetching full content. This is ideal for monitoring workflows, research pipelines, or any agent that needs to triage content before paying to retrieve it.

## Known failure modes

- Missing or invalid publication_id returns an error — publication_id is required
- Invalid or expired pagination cursor may return an error or unexpected results
- Query string exceeding 512 characters is rejected
- Limit value outside 1–20 range is rejected
- Unauthorized access (invalid payment or missing x402 credentials) returns a 402 Payment Required error
- Publication ID not approved in the Newstex MCP network returns a not-found or access-denied error

## How this service works

Newstex MCP Network: one page of metadata-only story search results.

## Output

Returns a JSON object with an array of story metadata objects (each containing article identifiers, titles, dates, and other metadata fields), a total result count, and an opaque next_cursor string for paginating to the next page of results.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "publication_id"
     ],
     "properties": {
      "q": {
       "type": "string",
       "maxLength": 512,
       "minLength": 1,
       "description": "Full-text query."
      },
      "limit": {
       "type": "integer",
       "maximum": 20,
       "minimum": 1
      },
      "cursor": {
       "type": "string",
       "description": "Opaque pagination cursor from a prior page."
      },
      "publication_id": {
       "type": "string",
       "description": "MCP-approved Newstex publication id."
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "hits": {
       "type": "array",
       "items": {
        "type": "object"
       }
      },
      "next_cursor": {
       "type": "string"
      },
      "result_count": {
       "type": "integer"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/newstex-story-search-metadata-f2e7373e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mcp.newstex.com](https://www.zero.xyz/host/mcp.newstex.com/llms.txt)