Model Context Protocol server for Alephant BYO-KEY that exposes FinOps metrics, virtual key management, and workspace analytics to MCP clients. It supports two modes: Virtual Key for scoped cockpit usage and Manager mode for workspace-wide administration using a PAT and workspace ID.
From the registry: Alephant MCP server for AI cost control, BYO-key routing, 50+ providers, and 320+ models.
Please install the `alephant-mcp` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Install Node.js and npm** — Node.js with npm is required to run the published MCP package via npx.
- **Obtain Alephant credentials** — Choose one authentication mode. Virtual Key mode requires ALEPHANT_VIRTUAL_KEY. Manager mode requires both ALEPHANT_PAT and ALEPHANT_WORKSPACE_ID. If neither Virtual Key nor PAT is set, the server exits with an error. PAT takes precedence when ALEPHANT_PAT is non-empty.
Canonical MCP server config (stdio transport):
- command: `npx`
- args: ["-y","@alephantai/mcp"]
- required environment variables:
- `ALEPHANT_API_BASE_URL`: Base URL for the Alephant API. Required in both Virtual Key and Manager modes. (example: `<your-alephant-api-base-url>`)
- `ALEPHANT_VIRTUAL_KEY`: Virtual Key for cockpit-scoped, read-only access. Use this in Virtual Key mode when not providing a PAT. (example: `<your-virtual-key>`)
- `ALEPHANT_PAT`: Personal Access Token for workspace-wide manager access. When non-empty, PAT mode takes precedence over Virtual Key mode. (example: `<your-personal-access-token>`)
- `ALEPHANT_WORKSPACE_ID`: Workspace identifier required together with ALEPHANT_PAT in Manager mode. (example: `<your-workspace-id>`)
- optional environment variables:
- `ALEPHANT_RATE_LIMIT_RPM`: Optional client-side rate limit in requests per minute. Default is 60; set to 0 to disable throttling. (example: `<your-rate-limit-rpm>`)
Note: This is a local stdio MCP server. Use one server entry per credential scope or workspace. There are two valid env configurations: (1) Virtual Key mode: ALEPHANT_API_BASE_URL + ALEPHANT_VIRTUAL_KEY, or (2) Manager mode: ALEPHANT_API_BASE_URL + ALEPHANT_PAT + ALEPHANT_WORKSPACE_ID. Do not set both modes unless you intend PAT mode to take precedence.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.ALEPHANT_API_BASE_URLrequiredBase URL for the Alephant APIALEPHANT_VIRTUAL_KEYrequiredVirtual key for VK mode accessALEPHANT_PATrequiredPersonal access token for Manager modeALEPHANT_WORKSPACE_IDrequiredWorkspace ID for Manager modeAI orchestration with hive-mind swarms, neural networks, and 87 MCP tools for enterprise dev.
Persistent codebase knowledge graph. Survives session restarts and context compaction.
A powerful toolkit for coding, providing semantic retrieval and editing capabilities.