supergateway
AGENTS.md3k starsChanged 21 days agoMITView on GitHub
Install Node.js v24 using nvm. After checking out the repository, run: Run the test suite with Node's test runner and ts-node to enable mocks: The tests/helpers/mock-mcp-server.js script provides a lightweight local MCP server used during tests so everything runs offline. All tests should pass without external downloads. If network-dependent commands (like npx -y @modelcontextprotocol/server-*) fail, check network access.
- Installs packages
Trending
More talk lately.about the whole repository
Who's talking about supercorp-ai/supergateway
- cline/cline“Remote MCP Integrations not working”GitHub · Mar 6, 2025 · 5 reactions
- langflow-ai/langflow“fail to access MCP SSE Server created by supergateway”GitHub · Apr 1, 2025 · 3 reactions
- @zottmann.dev“FWIW, I like github.com/supercorp-ai... for proxying stdio→SSE, it's quite solid for me but for context, …”Bluesky · Feb 21, 2026 · 1 likes
- A Hacker News story“Show HN: Supergateway – run AI MCP servers remotely”Hacker News · Dec 29, 2024 · 1 points
- A Hacker News story“Show HN: Supergateway – Run MCP stdio servers over SSE”Hacker News · Dec 21, 2024 · 1 points
The biggest 5 of 47 mentions linking to the repository that our crawl found. Each line is their own headline.
See all 47
Talked about on GitHub, Hacker News and Bluesky (47 times).
On GitHub · 44
- Mar 6, 2025Remote MCP Integrations not working — cline/cline5 reactions · 4 comments
- Apr 1, 2025fail to access MCP SSE Server created by supergateway — langflow-ai/langflow3 reactions · 6 comments
- Nov 3, 2026Bump supergateway from 3.4.3 to 4.2.1 in /docker/mcp/chrome-devtools — Flux29/fullstack0 reactions
- Nov 2, 2026Bump the "all-dependencies" group with 4 updates across multiple ecosystems — markhuangai/dense-mem0 reactions · 1 comment
- Nov 1, 2026chore(docker): bump supercorp-ai/supergateway from 3.4.3 to 4.2.1 in /docker — gjjisadog/book-download-mcp0 reactions
39 more on GitHub
- Nov 1, 2026chore(docker): bump supercorp-ai/supergateway from 3.4.3 to 4.2.1 in /docker — rookslog/zlibrary-mcp0 reactions · 3 comments
- Oct 31, 2026chore(fastmail_mcp_setup): bump supergateway to 4.2.1 — Farzy/self-config0 reactions · 1 comment
- Oct 30, 2026build(deps): bump supergateway from 4.1.0 to 4.2.1 in /Startup — jordanmrash/agent-of-record0 reactions
- Oct 28, 2026Bump supergateway from 4.2.0 to 4.2.1 in the node_modules group — steelshot/mcp-aggregator0 reactions
- Oct 23, 2026build(deps): bump supergateway from 4.1.0 to 4.2.0 in /Startup — jordanmrash/agent-of-record0 reactions · 1 comment
- Oct 20, 2026Bump supergateway from 3.4.3 to 4.2.0 in /docker/mcp/chrome-devtools — Flux29/fullstack0 reactions · 1 comment
- Oct 19, 2026Bump supergateway from 4.1.0 to 4.2.0 in the node_modules group — steelshot/mcp-aggregator0 reactions
- Oct 19, 2026Bump the "all-dependencies" group with 2 updates across multiple ecosystems — markhuangai/dense-mem0 reactions · 2 comments
- Oct 19, 2026build(deps): Bump supergateway from 4.1.0 to 4.2.0 in /src/mcps/runtime — freddy-jay/self-hosted-mcps0 reactions
- Oct 16, 2026chore(fastmail_mcp_setup): bump supergateway to 4.2.0 — Farzy/self-config0 reactions · 2 comments
- Oct 13, 2026chore(docker): bump supercorp-ai/supergateway from 3.4.3 to 4.1.0 in /docker — gjjisadog/book-download-mcp0 reactions · 1 comment
- Oct 9, 2026build(deps): bump supergateway from 3.4.3 to 4.1.0 in /Startup — jordanmrash/agent-of-record0 reactions
- Oct 6, 2026Bump supergateway from 3.4.3 to 4.1.0 in /docker/mcp/chrome-devtools — Flux29/fullstack0 reactions · 1 comment
- Oct 5, 2026Bump the "all-dependencies" group with 2 updates across multiple ecosystems — markhuangai/dense-mem0 reactions · 1 comment
- Oct 5, 2026build(deps): Bump supergateway from 3.4.3 to 4.1.0 in /src/mcps/runtime — freddy-jay/self-hosted-mcps0 reactions · 1 comment
- Oct 1, 2026chore(docker): bump supercorp-ai/supergateway from 3.4.3 to 4.1.0 in /docker — rookslog/zlibrary-mcp0 reactions · 2 comments
- Sep 29, 2026Bump supergateway from 3.4.3 to 4.0.0 in /docker/mcp/chrome-devtools — Flux29/fullstack0 reactions · 1 comment
- Sep 28, 2026Bump the "all-dependencies" group with 1 update across multiple ecosystems — markhuangai/dense-mem0 reactions · 2 comments
- Sep 28, 2026build(deps): Bump supergateway from 3.4.3 to 4.0.0 in /src/mcps/runtime — freddy-jay/self-hosted-mcps0 reactions · 1 comment
- Sep 25, 2026build(deps): bump supergateway from 3.4.3 to 4.0.0 in /Startup — jordanmrash/agent-of-record0 reactions · 1 comment
- Sep 20, 2026feat(container)!: Update image supercorp/supergateway to v4 — lenaxia/talos-ops-prod0 reactions · 52 comments
- Sep 18, 2026fix(fastmail_mcp): build supergateway from upstream repo, not Farzad's fork — Farzy/self-config0 reactions · 3 comments
- Jul 27, 2026Bundle newer MCP SDK in image so 2025-11-25 clients get tools — rwestergren/cronometer-api-mcp0 reactions
- Jul 24, 2026Feat: move all MCP's to their own container (remove from litellm and librechat) — javydekoning/homelab0 reactions
- Jul 24, 2026INFORMATION: Setting up Excalidash to support mcp on Coolify — davifernan/excalidash-mcp0 reactions · 1 comment
- Jun 29, 2026Refactor HTTP transport to use supergateway wrapper — gthieleb/email-mcp0 reactions
- May 31, 2026Feature Request: Add StreamableHTTP Transport to Lithos MCP Server — agent-lore/lithos0 reactions · 1 comment
- May 24, 2026MCP2ZigBee2MQTT — HTTP/SSE transport: `initialize` fails with `stream is not readable` — ichbinder/MCP2ZigBee2MQTT0 reactions
- Apr 19, 2026Add supergateway — TrivadisPF/platys-modern-data-platform0 reactions
- Mar 15, 2026SSE transport crashes on second connection — single Server instance reused across all connections — s-stefanov/actual-mcp0 reactions · 1 comment
- Feb 13, 2026Introduce Tool Gateways — agentic-layer/agent-runtime-operator0 reactions
- Oct 14, 2025建议直接用这个 https://github.com/supercorp-ai/supergateway — coding-alt/supergateway0 reactions
- Aug 11, 2025Add remote MCP capabilities — peschinskiy/yandex-maps-mcp0 reactions
- Jun 20, 2025dlx error with supergateway — pnpm/pnpm0 reactions · 1 comment
- Jun 16, 2025Connect to GitHub MCP server — breba-apps/disc-site0 reactions · 1 comment
- Jun 8, 2025How to setup an mcp type server in `http://localhost:8000/mcp` — langchain-ai/langchain-mcp-adapters0 reactions · 3 comments
- Jun 2, 2025feat(deps)!: Update dependency supergateway (2.8.3 → 3.4.3) — erhardtconsulting/mcp-collection0 reactions
- Jun 2, 2025feat(deps): update dependency supergateway (2.7.0 → 2.8.3) — erhardtconsulting/mcp-collection0 reactions
- Mar 31, 2025Why is this package not working with non-OpenAI models available in the ChatOpenAI class — langchain-ai/langchainjs-mcp-adapters0 reactions · 1 comment
On Hacker News · 2
- Dec 29, 2024Show HN: Supergateway – run AI MCP servers remotely1 point
- Dec 21, 2024Show HN: Supergateway – Run MCP stdio servers over SSE1 point
On Bluesky · 1
- Feb 21, 2026FWIW, I like github.com/supercorp-ai... for proxying stdio→SSE, it's quite solid for me but for context, I'm only using it locally in a… — @zottmann.dev1 likes and repost · 1 reply
Where files are headingNew AGENTS.md files have more rules about keeping secrets out of the code, and fewer about code style.
Of the AGENTS.md files we read, the 31,439 first seen in the last six months, against the older ones: the kind of rule that gained most share, and the kind that lost most. About files like this in general, not this one, and an estimate, since a kind is a pattern in the words.
The file
We split this AGENTS.md into the rules it gives an agent
2 rules. About 0 are common, 1 is distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈1
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 19
Run the test suite with Node's test runner and ts-node to enable mocks:
- Very specific: line 29
If network-dependent commands (like npx -y @modelcontextprotocol/server-*) fail, check network access.
≈ “Common” is an estimate: at least 1 in 5 of the 40,246 AGENTS.md files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Setup
Install Node.js v24 using nvm. After checking out the repository, run:
nvm install 24
nvm use 24
npm install
# Build
Compile the TypeScript sources before running tests:
npm run buildRunning tests
Run the test suite with Node's test runner and ts-node to enable mocks:
npm run testThe tests/helpers/mock-mcp-server.js script provides a lightweight local MCP
server used during tests so everything runs offline. All tests should pass
without external downloads.
If network-dependent commands (like npx -y @modelcontextprotocol/server-*) fail, check network access.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

