# Install Koskamo in an agent
Copy a client-specific snippet from https://koskamo.com/data/connect. Public reads need no API key. The endpoint is Streamable HTTP at https://koskamo.com/api/mcp.
Claude Code:
claude mcp add --transport http koskamo https://koskamo.com/api/mcp
Codex:
codex mcp add koskamo --url https://koskamo.com/api/mcp
Grok:
grok mcp add --transport http koskamo https://koskamo.com/api/mcp
Gemini CLI:
gemini mcp add --transport http koskamo https://koskamo.com/api/mcp
Cline requires "type": "streamableHttp" in cline_mcp_settings.json. Omitting the type falls back to SSE and this server returns HTTP 405.
Cursor uses .cursor/mcp.json with mcpServers.koskamo.url. VS Code uses .vscode/mcp.json with servers.koskamo.type "http". Windsurf uses serverUrl in ~/.codeium/windsurf/mcp_config.json. Zed uses context_servers in settings.json. Claude Desktop uses claude_desktop_config.json.
Retrieve without MCP:
curl --fail-with-body https://koskamo.com/api/v1/retrieve \
-H 'Content-Type: application/json' \
-d '{"query":"What is Koskamo?","dataset":"koskamo-docs","top_k":5}'
Discovery: https://koskamo.com/.well-known/mcp.json
OpenAPI: https://koskamo.com/api/v1/openapi.json
Use koskamo_retrieve before answering questions about Koskamo. Cite datasetSlug, documentTitle, and documentVersion. Propose revisions when you have a better fact; wait for approval.