Wso2 Docs MCP Server

by iamvirulio.github.iamvirul/wso2-docs-mcp-serverv1.2.0

Semantic search over WSO2 docs (APIM, MI, Choreo, Ballerina) via RAG and pgvector.

3Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active5d ago

Install Wso2 Docs MCP server

claude mcp add wso2-docs -e DATABASE_URL='<database-url>' -e OPENAI_API_KEY='<openai-api-key>' -e GEMINI_API_KEY='<gemini-api-key>' -e VOYAGE_API_KEY='<voyage-api-key>' -- npx -y wso2-docs-mcp-server

{
  "mcpServers": {
    "wso2-docs": {
      "command": "npx",
      "args": [
        "-y",
        "wso2-docs-mcp-server"
      ],
      "env": {
        "DATABASE_URL": "<database-url>",
        "OPENAI_API_KEY": "<openai-api-key>",
        "GEMINI_API_KEY": "<gemini-api-key>",
        "VOYAGE_API_KEY": "<voyage-api-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "wso2-docs": {
      "command": "npx",
      "args": [
        "-y",
        "wso2-docs-mcp-server"
      ],
      "env": {
        "DATABASE_URL": "<database-url>",
        "OPENAI_API_KEY": "<openai-api-key>",
        "GEMINI_API_KEY": "<gemini-api-key>",
        "VOYAGE_API_KEY": "<voyage-api-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "wso2-docs": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "wso2-docs-mcp-server"
      ],
      "env": {
        "DATABASE_URL": "<database-url>",
        "OPENAI_API_KEY": "<openai-api-key>",
        "GEMINI_API_KEY": "<gemini-api-key>",
        "VOYAGE_API_KEY": "<voyage-api-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "wso2-docs": {
      "command": "npx",
      "args": [
        "-y",
        "wso2-docs-mcp-server"
      ],
      "env": {
        "DATABASE_URL": "<database-url>",
        "OPENAI_API_KEY": "<openai-api-key>",
        "GEMINI_API_KEY": "<gemini-api-key>",
        "VOYAGE_API_KEY": "<voyage-api-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
DATABASE_URL	yes	—	PostgreSQL connection string for pgvector (e.g. postgresql://user:pass@localhost:5432/wso2docs)
EMBEDDING_PROVIDER	—	—	Embedding backend to use: ollama (default, local), openai, gemini, or voyage
OPENAI_API_KEY	—	yes	Required only when EMBEDDING_PROVIDER=openai
GEMINI_API_KEY	—	yes	Required only when EMBEDDING_PROVIDER=gemini
VOYAGE_API_KEY	—	yes	Required only when EMBEDDING_PROVIDER=voyage

Freshness

Active — last maintenance signal 5d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-05 · 5d ago · GitHub
Latest release
2026-09-16 · 24d ago · GitHub · v1.3.12
Package published
no data · npm/PyPI
Registry entry updated
2026-03-29 · 7mo ago · official registry · v1.2.0

FAQ

›How do I install the Wso2 Docs MCP server in Claude Code?

Run: claude mcp add wso2-docs -e DATABASE_URL='<database-url>' -e OPENAI_API_KEY='<openai-api-key>' -e GEMINI_API_KEY='<gemini-api-key>' -e VOYAGE_API_KEY='<voyage-api-key>' -- npx -y wso2-docs-mcp-server. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Wso2 Docs require an API key?

Yes. It expects DATABASE_URL, OPENAI_API_KEY, GEMINI_API_KEY, VOYAGE_API_KEY, of which 3 are secrets.

›Can I use Wso2 Docs as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Wso2 Docs in the official MCP registry?

Yes, as io.github.iamvirul/wso2-docs-mcp-server.