Koskamo

npx add-mcp 'https://koskamo.com/api/mcp'

1. Choose how to connect

Public reads are free and need no key. This endpoint uses Streamable HTTP.

Run this once in a terminal. It registers a Streamable HTTP server named koskamo. Use --scope project to write.mcp.json for the repo.

claude mcp add --transport http koskamo https://koskamo.com/api/mcp

Configuration reference

For other MCP clients, add a remote HTTP server using the endpoint below. Follow your client’s setup instructions.

https://koskamo.com/api/mcp

2. Verify the service

This checks the server from this browser. Your agent’s own connection is verified when it can perform the lookup in step 3.

3. Ask your agent

Use Koskamo to find the official GitHub MCP server. Show its endpoint, authentication, documented prerequisites, and setup link. Treat missing prerequisites as unknown.

Expect GitHub’s official endpoint, OAuth access, recorded prerequisites, and a setup link. Public discovery is free; using a listed server may require a vendor account, permissions, or payment.

Tools the server advertises

• koskamo_search_mcp_servers Find live-checked, vendor-run MCP servers with endpoints, access requirements, and setup links.
• koskamo_search_passages Cited lookup from public datasets.
• koskamo_list_datasets List datasets an agent may search.
• koskamo_get_history Document version timeline, including deletions.
• koskamo_list_revisions Pending or decided proposals for a dataset.
• koskamo_register_mcp_server List a server you operate: prove the domain, pass the live check, publish.
• koskamo_report_fact Flag a passage that looks wrong, outdated, or uncited. A reviewer checks it; no key needed.

Limits: 30 retrieve requests or 40 MCP messages per minute per IP. On HTTP 429, wait for Retry-After before retrying. Proposing and deciding revisions need a contributor key on https://koskamo.com/api/mcp/contributor, and proposals stay pending until the dataset owner approves them.

Client verification

Setup instructions and a successful endpoint check do not prove a native client workflow. These records distinguish completed client tests from guides that still need verification.

Claude Code

Passed with isolated data

Tested client version 2.1.317 · 2026-11-03T21:02:02.500Z

Actual client process: owned intake, exact source read, fresh-process reconnect and response-loss recovery; zero duplicate effects.

Codex

Passed with isolated data

Tested client version 0.166.0 · 2026-11-03T21:13:51.554Z

Actual client process: owned intake, exact source read, fresh-process reconnect and response-loss recovery; zero duplicate effects.

Grok Build CLI

Passed with isolated data

Tested client version 1.0.70 · 2026-11-03T21:29:34.047Z

Actual client process: owned intake, exact source read, fresh-process reconnect and response-loss recovery; zero duplicate effects.

Cursor

Not yet tested

Client is not installed in this test environment; workflow acceptance has not been run.

Cline

Not yet tested

Setup guidance is available; no representative native workflow has been verified here.

VS Code

Not yet tested

Setup guidance is available; no representative native workflow has been verified here.

Gemini CLI

Blocked

Tested client version 0.66.0

Provider rejected the installed client as unsupported for its current authentication tier. Acceptance has not passed.

Claude Desktop

Not yet tested

Setup guidance is available; no representative native workflow has been verified here.

Windsurf

Not yet tested

Client is not installed in this test environment; workflow acceptance has not been run.

ChatGPT

Not yet tested

Setup guidance is available; no representative native workflow has been verified here.

Zed

Not yet tested

Setup guidance is available; no representative native workflow has been verified here.

Completed tests used disposable data and real MCP routes. They do not verify your local installation, provider grants or a real GitHub write.

Choose your MCPs

Save private server and tool selections, generate setup, and configure the controlled GitHub issue and comment gateway.

Manage selected MCPs

Example prompts

Three requests to try once Koskamo is connected.

Find a known server

Use Koskamo to find the official GitHub MCP server. Show its endpoint, authentication, documented prerequisites, and setup link. Treat missing prerequisites as unknown.

Find a server for a task

Use Koskamo to find an MCP for error monitoring in Cursor. Explain its documented capabilities, unknown prerequisites, readiness evidence, and manual connection plan.

Look up a cited fact

Use Koskamo to look up how HTTP Retry-After works in the agent-integration-reference dataset. Quote the passage and give its source and document version.

Troubleshooting

What each HTTP error from the MCP endpoint means and how to clear it.

400 Unsupported MCP-Protocol-Version

Send one of 2025-11-25, 2025-06-18, 2025-03-26.

400 This endpoint takes no credentials

/api/mcp is public, so remove the Authorization header. Keyed access to contributions and private datasets is at /api/mcp/contributor.

401 Invalid API key

/api/mcp/contributor needs a valid bearer key; this one is missing, wrong, or revoked. Create a key in the manage console, or use /api/mcp, which needs none.

403 Origin is not allowed

The request carries a browser Origin other than koskamo.com. Call the endpoint from a server-side client.

405 No SSE stream

This endpoint is POST-only. Configure the client for Streamable HTTP, not SSE.

406 Accept header

Send Accept: application/json, text/event-stream.

415 Content-Type header

Send Content-Type: application/json.

429 Too many MCP requests

Wait for the Retry-After interval. The limit is 40 MCP messages per minute per IP.

503 Knowledge service unavailable

A temporary backend failure. Retry later.