Reddit data for agents

Official6 tools

by reddit

15 Reddit endpoints. Pay per call in USDC via x402.

sh.fetcher.reddit/mcp (MCP) Server

The sh.fetcher.reddit/mcp server exposes 15 Reddit endpoints via an MCP interface. Access is described as pay per call in USDC, using x402 for billing. This server provides a standardized way to call specific Reddit-related endpoints from developer tooling that supports MCP.

🛠️ Key Features

15 Reddit endpoints
Pay per call billing
Payments in USDC via x402

🚀 Use Cases

Calling a defined set of Reddit endpoints through MCP
Building integrations that require multiple Reddit data/actions while using per-call billing

⚠️ Limitations

Limited to the 15 endpoints provided by this server
Usage requires USDC payments processed through x402

Captured live from the server via tools/list.

search_endpoints

Free. Search fetcher.sh's Reddit endpoints by keyword. Returns paths, descriptions and per-call prices. Start here.

Parameters1

query

string

optional

Keywords, e.g. 'twitter followers' or 'reviews'

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Keywords, e.g. 'twitter followers' or 'reviews'"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

describe_endpoint

Free. Show the full call signature for one endpoint: required and optional parameters, allowed values, price, and response shape.

Parameters1

path

string

required

Endpoint path, e.g. /api/twitter/search or /api/twitter/handle/{handle}

Raw schema

{
  "type": "object",
  "properties": {
    "path": {
      "type": "string",
      "description": "Endpoint path, e.g. /api/twitter/search or /api/twitter/handle/{handle}"
    }
  },
  "required": [
    "path"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

fetch_data

Paid. Fetch live data from any Reddit endpoint. Pass the endpoint path plus its parameters (path and query parameters together in `params`). Priced per call in USDC on Base, Polygon, Arbitrum, Monad or Solana: pay with x402, or send an Authorization: Bearer bby_live_... header to spend prepaid credits. Call describe_endpoint first if unsure about parameters.

Parameters2

path	string	required	Endpoint path from search_endpoints, e.g. /api/reddit/search/post
params	object	optional	All parameters for the endpoint, path and query alike, e.g. { query: 'x402', sort: 'Latest' }

Raw schema

{
  "type": "object",
  "properties": {
    "path": {
      "type": "string",
      "description": "Endpoint path from search_endpoints, e.g. /api/reddit/search/post"
    },
    "params": {
      "type": "object",
      "additionalProperties": {
        "type": [
          "string",
          "number",
          "boolean"
        ]
      },
      "description": "All parameters for the endpoint, path and query alike, e.g. { query: 'x402', sort: 'Latest' }"
    }
  },
  "required": [
    "path"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

check_balance

Free. Show the remaining credit balance for the API key sent in this connection's Authorization header. Call this before a long run of paid requests.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

topup_credits

Paid (the amount you choose, minimum $1). Buy prepaid credits with x402 so later calls skip the per-call payment round trip. With an Authorization: Bearer bby_live_... header on this connection it recharges that key. Without one, the paying wallet becomes the account and a new API key is minted and returned once — store it as a secret, it cannot be recovered.

Parameters2

amount	number	required	Amount to add, in USD. Minimum 1.
rotate	boolean	optional	Mint a replacement key for the paying wallet, invalidating the old one immediately. Only valid when no Authorization header is sent.

Raw schema

{
  "type": "object",
  "properties": {
    "amount": {
      "type": "number",
      "minimum": 1,
      "description": "Amount to add, in USD. Minimum 1."
    },
    "rotate": {
      "type": "boolean",
      "description": "Mint a replacement key for the paying wallet, invalidating the old one immediately. Only valid when no Authorization header is sent."
    }
  },
  "required": [
    "amount"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

reddit_search_post

Paid ($0.002). Search post — Reddit. Live data as JSON. Pay with x402 or an Authorization: Bearer bby_live_... credits key.

Parameters3

keyword	string	required	Required.
sort	string	optional	Optional. One of: relevance, hot, new, top, comments.
cursor	string	optional	Optional.

Raw schema

{
  "type": "object",
  "properties": {
    "keyword": {
      "type": "string",
      "description": "Required."
    },
    "sort": {
      "type": "string",
      "enum": [
        "relevance",
        "hot",
        "new",
        "top",
        "comments"
      ],
      "description": "Optional. One of: relevance, hot, new, top, comments."
    },
    "cursor": {
      "type": "string",
      "description": "Optional."
    }
  },
  "required": [
    "keyword"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Install

Tools (6)

search_endpointsdescribe_endpointfetch_datacheck_balancetopup_creditsreddit_search_post

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://reddit.fetcher.sh/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://reddit.fetcher.sh/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

Reddit data for agents - agentage MCP Catalog