Stophy MCP server

Stophy MCP

Live data from 40+ sites for AI agents over MCP: web search, YouTube, Reddit, Google Maps, Amazon, jobs, real estate, ads, stocks and crypto. Your agent reaches every Stophy endpoint through three MCP tools.

Connect to the hosted server

Most apps can connect to the hosted server directly. There is nothing to install.

Get an API key at stophy.dev/signup.

Claude

In Claude on the web, Desktop or mobile, open Customize > Connectors, choose Add custom connector, and paste https://api.stophy.dev/mcp-oauth. Sign in when Claude asks.

Claude Code

To sign in with your browser, add the server, then run /mcp and choose Authenticate:

claude mcp add --transport http stophy https://api.stophy.dev/mcp-oauth

To use an API key:

claude mcp add --transport http stophy https://api.stophy.dev/mcp --header "Authorization: Bearer <key>"

To start without a key:

claude mcp add --transport http stophy https://api.stophy.dev/mcp

Codex

To use the key in your STOPHYAPIKEY environment variable:

codex mcp add stophy --url https://api.stophy.dev/mcp --bearer-token-env-var STOPHY_API_KEY

To sign in with your browser instead, add the sign-in URL, then log in:

codex mcp add stophy --url https://api.stophy.dev/mcp-oauth
codex mcp login stophy

Cursor

Use the Add to Cursor button above to sign in with your browser, or add this to .cursor/mcp.json to use a key:

{
  "mcpServers": {
    "stophy": {
      "url": "https://api.stophy.dev/mcp",
      "headers": { "Authorization": "Bearer <key>" }
    }
  }
}

To start without a key, leave out headers.

Run it as a local server

Some apps can only start a local MCP server. For those, use this package. It runs on your computer and passes every request to the hosted server, so it always has the same tools.

npx -y @stophy/mcp

With STOPHYAPIKEY set, your agent can use every endpoint. Without it, your agent gets the free endpoints.

Claude Desktop

Add this to claudedesktopconfig.json, then restart Claude Desktop:

{
  "mcpServers": {
    "stophy": {
      "command": "npx",
      "args": ["-y", "@stophy/mcp"],
      "env": { "STOPHY_API_KEY": "<key>" }
    }
  }
}

To start without a key, leave out env.

The package needs Node.js 18 or later.

Tools

Your agent usually searches, then describes, then calls. Endpoint ids are camelCase, such as webSearch or youtubeSearch. Lists come back as results, and fields keeps only the keys you name on each row. Each result says how many credits it used. One call returns one page for one flat price, and limit on a list endpoint keeps at most that many rows from the page at the same price.

More

Shortened. The full README is on GitHub.