Stackexchange Mcp

stackexchange-mcp

An MCP server that lets your AI assistant search Stack Overflow and other Stack Exchange sites, read questions with their best answers, and ground its debugging help in real, voted answers instead of guessing.

• Read-only: it never posts, votes or edits anything.
• Model-friendly output: short summaries, Markdown instead of HTML, code blocks preserved, long posts truncated with a link.
• Respects the API: optional API key, backoff handling, request spacing, retries, caching and quota tracking.
• Clear errors: every failure tells the model what happened and what to try next.

Not affiliated with Stack Exchange, Inc. Content returned by the API is licensed CC BY-SA (3.0 or 4.0 depending on the post). The server returns the author, link and license so assistants can attribute it.

What it provides

[project] name = "mcp-server" version = "0.1.0" requires-python = ">=3.12" dependencies = [ "httpx>=0.28.1", "mcp[cli]>=1.0,<2", "pydantic>=2.14.2", ]

[dependency-groups] dev = [ "pytest>=9.2.0", ]

Tools

Resources

Prompts

Quick start

1. Get a free API key (recommended)

The server works without a key, but the anonymous quota is small: the API reported 300 requests per day without a key and 10,000 with one. Register an app on Stack Apps to get a key; you do not need OAuth for read-only use.

2. Install

You need uv. The server runs straight from PyPI:

uvx stackexchange-mcp

(That starts a stdio server and waits; you normally let your AI app launch it using one of the configs below.)

3. Connect your AI app

Use the full path to uvx if your app cannot find it (which uvx).

VS Code (GitHub Copilot, Agent mode) - .vscode/mcp.json:

{  "servers": {    "stackexchange": {      "type": "stdio",      "command": "uvx",      "args": ["stackexchange-mcp"],      "env": { "STACKEXCHANGE_KEY": "${input:se_key}" }    }  },  "inputs": [    {      "type": "promptString",      "id": "se_key",      "description": "Stack Exchange API key",      "password": true    }  ]}

Antigravity CLI - .agents/mcp_config.json in your project (or ~/.gemini/config/mcp_config.json globally):

{  "mcpServers": {    "stackexchange": {      "command": "uvx",      "args": ["stackexchange-mcp"],      "env": { "STACKEXCHANGE_KEY": "your-key" }    }  }}

Start agy and run /mcp to confirm it is connected.

Claude Code:

claude mcp add --env STACKEXCHANGE_KEY=your-key stackexchange -- uvx stackexchange-mcp

Claude Desktop (macOS/Windows) and Cursor - same JSON shape as Antigravity (mcpServers), in claude_desktop_config.json or ~/.cursor/mcp.json.

Keep your key out of files you commit.

Configuration

Rate limits and errors

• Identical requests within the cache window cost no quota.
• If the API sends a backoff value, the server waits it out (up to 10 seconds) before the next call; longer waits are reported instead of blocking.
• Requests are spaced at least 0.2 seconds apart.
• Timeouts, network errors and 5xx responses are retried twice with exponential delay (0.5 s, then 1 s).
• When the daily quota is exhausted the server stops calling the API until the next UTC day.

The API key is never written to logs or error messages.

Example prompts

You do not need to name a tool. Things that should make the assistant use this server:

• "What's the difference between asyncio.sleep and time.sleep? Check Stack Overflow."
• "I get AttributeError: 'NoneType' object has no attribute 'foo' - find help on Stack Overflow." (paste the traceback)
• "Is there a Stack Overflow tag for testing async code with pytest?"
• "I'm new to python-asyncio. Give me an overview from Stack Overflow."
• "Find recent discussions about Docker networking on Server Fault."

Tested with

Results for each prompt are in TESTING.md.

• Antigravity CLI: connects and lists all 6 tools. In a 10-prompt run, the model picked the expected tool without being told its name in 9 of 10 prompts (one prompt still needs a re-run) and chose sensible arguments such as site, sort and accepted_only. It correctly used no tool for an unrelated question.
• VS Code (Copilot Agent mode): the server starts and 6 tools are discovered; tool-call results are not recorded yet.
• MCP Inspector: connects and lists the server's tools (re-check all resources and prompts before release).

Troubleshooting

• Server "anonymous (low quota)" in the log: the key did not reach the server. Put STACKEXCHANGE_KEY in the env block of your client's config.
• Command not found: use the absolute path of uvx in the config.
• VS Code shows no tools: use a normal Copilot Agent mode chat session in a workspace that contains .vscode/mcp.json; some session types keep their own separate server list.
• The assistant never calls a tool: ask it explicitly once ("search Stack Overflow for ...") and check the tool list in your client.
• Logs: the server writes logs to stderr (never stdout, which carries the protocol). In VS Code, open the Output panel and choose the server.

Development

git clone https://github.com/YashLimbani/stackexchange-mcpcd stackexchange-mcpuv syncuv run pytest -qnpx @modelcontextprotocol/inspector uv run stackexchange-mcp

Tests need no network: the API is mocked using real saved responses in samples/. See DESIGN.md for the design and CONTRIBUTING.md for how to help.

License

MIT for the code (see LICENSE). Stack Exchange content is CC BY-SA; attribute the author and link when you reuse it.