Alephantai MCP Server
by alephantaiio.github.AlephantAI/alephant-mcpv0.1.3
Alephant MCP server for AI cost control, BYO-key routing, 50+ providers, and 320+ models.
context tax
queued
security
queued
cold start
queued
freshness
Slowing5mo ago
Install Alephantai MCP server
Install in Claude Code
claude mcp add alephantai -e ALEPHANT_API_BASE_URL='<alephant-api-base-url>' -e ALEPHANT_VIRTUAL_KEY='<alephant-virtual-key>' -e ALEPHANT_PAT='<alephant-pat>' -- npx -y @alephantai/mcpInstall in Cursor
{
"mcpServers": {
"alephantai": {
"command": "npx",
"args": [
"-y",
"@alephantai/mcp"
],
"env": {
"ALEPHANT_API_BASE_URL": "<alephant-api-base-url>",
"ALEPHANT_VIRTUAL_KEY": "<alephant-virtual-key>",
"ALEPHANT_PAT": "<alephant-pat>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"alephantai": {
"command": "npx",
"args": [
"-y",
"@alephantai/mcp"
],
"env": {
"ALEPHANT_API_BASE_URL": "<alephant-api-base-url>",
"ALEPHANT_VIRTUAL_KEY": "<alephant-virtual-key>",
"ALEPHANT_PAT": "<alephant-pat>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"alephantai": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@alephantai/mcp"
],
"env": {
"ALEPHANT_API_BASE_URL": "<alephant-api-base-url>",
"ALEPHANT_VIRTUAL_KEY": "<alephant-virtual-key>",
"ALEPHANT_PAT": "<alephant-pat>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"alephantai": {
"command": "npx",
"args": [
"-y",
"@alephantai/mcp"
],
"env": {
"ALEPHANT_API_BASE_URL": "<alephant-api-base-url>",
"ALEPHANT_VIRTUAL_KEY": "<alephant-virtual-key>",
"ALEPHANT_PAT": "<alephant-pat>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| ALEPHANT_API_BASE_URL | yes | — | Alephant SaaS API base URL, for example https://alephant.io. |
| ALEPHANT_VIRTUAL_KEY | — | yes | Virtual Key for read-only, cockpit-scoped VK mode. Use this mode for developer-level cost and usage visibility. |
| ALEPHANT_PAT | — | yes | Personal Access Token for Manager mode. When set, Manager mode takes precedence over ALEPHANT_VIRTUAL_KEY. |
| ALEPHANT_WORKSPACE_ID | — | — | Workspace UUID required with ALEPHANT_PAT for Manager mode. |
| ALEPHANT_RATE_LIMIT_RPM | — | — | Optional local HTTP tool-call limit per minute. Defaults to 60; set 0 to disable local throttling. |
Freshness
Slowing — last maintenance signal 5mo ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-05-16 · 5mo ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-05-16 · 5mo ago · official registry · v0.1.3
FAQ
›How do I install the Alephantai MCP server in Claude Code?
Run: claude mcp add alephantai -e ALEPHANT_API_BASE_URL='<alephant-api-base-url>' -e ALEPHANT_VIRTUAL_KEY='<alephant-virtual-key>' -e ALEPHANT_PAT='<alephant-pat>' -- npx -y @alephantai/mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Alephantai require an API key?
Yes. It expects ALEPHANT_API_BASE_URL, ALEPHANT_VIRTUAL_KEY, ALEPHANT_PAT, of which 2 are secrets.
›Can I use Alephantai as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is Alephantai in the official MCP registry?
Yes, as io.github.AlephantAI/alephant-mcp.