Alephant Mcp
Connects your MCP host to Alephant's BYO-KEY platform for AI cost control across 50+ providers and 320+ models. Runs in two modes: Virtual Key mode exposes read-only cockpit usage, budgets, and recent requests (8 tools), while Manager mode with PAT credentials unlocks workspace-wide analytics, virtual key lifecycle operations, agent/member/department drill-downs, and cost anomaly detection (27 tools). Both modes surface daily costs, model breakdowns, and usage summaries. Reach for this when you need LLM spend visibility and guardrails inside Cursor, Claude Desktop, or any stdio-compatible client. Built for teams running distributed AI workloads who want FinOps metrics without leaving their editor.
- tools
- 30
- auth
- Secret needed
- transport
- STDIO
- env vars
- 5
- last updated
- May 16, 2026
Tools
30 toolsPublic tool metadata for what this MCP can expose to an agent.
check_alephant_connectionShared tool available in both VK and Manager modes.
Shared tool available in both VK and Manager modes.
No parameter schema in public metadata yet.
get_usage_summaryShared tool available in both VK and Manager modes.
Shared tool available in both VK and Manager modes.
No parameter schema in public metadata yet.
get_daily_costsShared tool available in both VK and Manager modes.
Shared tool available in both VK and Manager modes.
No parameter schema in public metadata yet.
get_cost_by_modelShared tool available in both VK and Manager modes.
Shared tool available in both VK and Manager modes.
No parameter schema in public metadata yet.
list_available_modelsShared tool available in both VK and Manager modes.
Shared tool available in both VK and Manager modes.
No parameter schema in public metadata yet.
get_my_scopeVK only tool.
VK only tool.
No parameter schema in public metadata yet.
get_my_budgetVK only tool.
VK only tool.
No parameter schema in public metadata yet.
get_my_recent_requestsVK only tool.
VK only tool.
No parameter schema in public metadata yet.
get_workspace_overviewManager only tool.
Manager only tool.
No parameter schema in public metadata yet.
get_workspace_budget_statusManager only tool.
Manager only tool.
No parameter schema in public metadata yet.
list_virtual_keysManager only tool.
Manager only tool.
No parameter schema in public metadata yet.
create_virtual_keyManager only tool.
Manager only tool.
No parameter schema in public metadata yet.
update_key_budgetManager only tool.
Manager only tool.
No parameter schema in public metadata yet.
revoke_virtual_keyManager only tool.
Manager only tool.
No parameter schema in public metadata yet.
list_agentsManager only tool.
Manager only tool.
No parameter schema in public metadata yet.
get_agent_analyticsManager only tool.
Manager only tool.
No parameter schema in public metadata yet.
list_membersManager only tool.
Manager only tool.
No parameter schema in public metadata yet.
get_member_analyticsManager only tool.
Manager only tool.
No parameter schema in public metadata yet.
list_departmentsManager only tool.
Manager only tool.
No parameter schema in public metadata yet.
get_department_analyticsManager only tool.
Manager only tool.
No parameter schema in public metadata yet.
get_subscription_infoManager only tool.
Manager only tool.
No parameter schema in public metadata yet.
set_budget_policyManager only tool.
Manager only tool.
No parameter schema in public metadata yet.
get_live_24hManager only tool.
Manager only tool.
No parameter schema in public metadata yet.
get_usage_timeseriesManager only tool.
Manager only tool.
No parameter schema in public metadata yet.
get_sparklinesManager only tool.
Manager only tool.
No parameter schema in public metadata yet.
diagnose_cost_anomalyManager only tool.
Manager only tool.
No parameter schema in public metadata yet.
get_executive_dashboardManager only tool.
Manager only tool.
No parameter schema in public metadata yet.
drill_down_spendManager only tool.
Manager only tool.
No parameter schema in public metadata yet.
find_idle_resourcesManager only tool.
Manager only tool.
No parameter schema in public metadata yet.
compare_entity_periodsManager only tool.
Manager only tool.
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
ALEPHANT_API_BASE_URL*Alephant SaaS API base URL, for example https://alephant.io.
ALEPHANT_VIRTUAL_KEYsecretVirtual Key for read-only, cockpit-scoped VK mode. Use this mode for developer-level cost and usage visibility.
ALEPHANT_PATsecretPersonal Access Token for Manager mode. When set, Manager mode takes precedence over ALEPHANT_VIRTUAL_KEY.
ALEPHANT_WORKSPACE_IDWorkspace UUID required with ALEPHANT_PAT for Manager mode.
ALEPHANT_RATE_LIMIT_RPMOptional local HTTP tool-call limit per minute. Defaults to 60; set 0 to disable local throttling.
Readme
Alephant MCP Server
Model Context Protocol server for Alephant BYO-KEY: FinOps metrics, virtual keys, and workspace analytics from Cursor, Claude Desktop, or any MCP host.
Modes
| Mode | Environment | Tools |
|---|---|---|
| VK | ALEPHANT_VIRTUAL_KEY | Cockpit-scoped usage + 3 VK tools (8 tools total incl. shared) |
| Manager | ALEPHANT_PAT + ALEPHANT_WORKSPACE_ID | Workspace-wide management (27 tools total incl. shared) |
PAT takes precedence when ALEPHANT_PAT is non-empty. If neither VK nor PAT is set, the process exits with an error (no mock data).
Required (both modes): ALEPHANT_API_BASE_URL
Optional: ALEPHANT_RATE_LIMIT_RPM (default 60, use 0 to disable client-side throttling)
Windows / npx troubleshooting
From this repo’s root (alephant-mcp/): do not use npx -y @alephantai/mcp to “smoke test” the published package. npm treats the current directory as the local @alephantai/mcp project and does not link the root package’s bin into node_modules/.bin, so Windows then fails with 'alephant-mcp' is not recognized (or the Chinese CMD equivalent).
Details
- Repository
- github.com/alephantai/alephant-mcp
- Package
@alephantai/mcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active