packetstream/packetstream-mcp

PacketStream runs a hosted Model Context Protocol (MCP) server that gives AI agents and LLM apps two web tools. packetstreamsearch runs a live search on the world's most-used search engine and returns the results as Markdown and JSON. packetstreamfetch fetches a web page through PacketStream's residential network and returns the page itself as Markdown, not a summary. Connect it to Claude Code, Codex, Cursor, Gemini CLI, VS Code, Claude Desktop, Cline or any other MCP client that supports remote servers. Each successful call costs $0.0025 ($2.50 per 1,000) from a prepaid balance, with no subscription; see Pricing.
This repository holds the plugin and extension files for Claude Code, Codex, Cursor and Gemini CLI. The server runs at PacketStream, so you host nothing. Install the plugin for your client, or point any MCP client at the server URL.
Full documentation:
## Tools: web search and page fetching
| Tool | What it does |
| packetstreamsearch | Runs a live web search and returns the results as Markdown, with the JSON response as structured content. You can set the country, language, location, device, page and time range. Result types: search, news, shopping, places, autocomplete, scholar and aimode. |
| packetstreamfetch | Reads one public http or https page and returns it as Markdown, not a summary, with the final URL, HTTP status and title. The request goes through PacketStream's residential network. |
Both tools only read. Apart from the charge for each successful call, they change nothing on your computer or in your PacketStream account.
Good to know about packetstreamfetch:
It reads static HTML only. A page that needs JavaScript returns an error.
It returns up to 40,000 characters by default. For a longer page, the agent calls it again from the next character.
It does not read robots.txt. You decide which sites your agent reads, and you need any permission the law, a contract or the site operator requires. See section 7 of our Terms of Service.
It marks page text as untrusted, so the agent treats it as data and not as instructions.
The MCP reference lists every argument and result format. The same API key also works with the REST Search API and Fetch API if you want to call them from your own code.
## Server URLs
There are two URLs. Both serve the same tools at the same price. Use your client's Streamable HTTP transport.
| URL | How you connect |
| https://api.packetstream.io/v1/mcp/oauth | Sign in with your PacketStream account. Your client opens a PacketStream page in your browser, and you select Allow. No key goes in a config file. |
| https://api.packetstream.io/v1/mcp | API key, sent as Authorization: Bearer YOURAPIKEY. For clients that let you set a header. |
The plugins in this repository use the sign-in URL.
## Before you begin
1. Sign up and add funds to your balance.
2. If your client uses an API key, create one on the MCP page of the dashboard. The key is shown once, so copy it when it appears.
## Install the plugin or connect your client
### Claude Code
bash
claude plugin marketplace add packetstream/packetstream-mcp
claude plugin install packetstream@packetstream
On Claude Code 2.1.275 or later, you can do both in one step inside Claude Code: