MCP Server

Connect AI coding tools to AICredits with the official MCP server. Live model lists, INR pricing, credit balance, usage, API keys, and docs search — without leaving your editor.

The AICredits MCP (Model Context Protocol) server plugs AICredits into the AI tools you already use. Once connected, your assistant can pull live AICredits data — models, INR pricing, your credit balance, usage, and API keys — all without leaving your editor.

It's a remote server hosted by AICredits — nothing is installed locally.

Connect

The MCP server authenticates with a management key (akm-…), not an inference key. Your inference key (sk-live-…) will not work here.

Get a management key: open the Management API page in your dashboard (sidebar → Management API), click Create management key, and grant only the scopes you want the assistant to have (wallet:read, usage:read, keys:read). The key is shown once. You can also revoke it from the same page at any time.

claude mcp add --transport http aicredits https://api.aicredits.in/mcp \
  --header "Authorization: Bearer akm-YOUR-MANAGEMENT-KEY"

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "aicredits": {
      "url": "https://api.aicredits.in/mcp",
      "headers": { "Authorization": "Bearer akm-YOUR-MANAGEMENT-KEY" }
    }
  }
}

Any client supporting streamable HTTP transport:

{
  "url": "https://api.aicredits.in/mcp",
  "transport": "http",
  "headers": { "Authorization": "Bearer akm-YOUR-MANAGEMENT-KEY" }
}

Grant the management key only the scopes the assistant needs. A leaked key limited to wallet:read + usage:read can only read — it can't create keys or spend credits.

Tools

All tools are read-only lookups against live AICredits data. Each account-data tool checks the management key's scopes.

Tool	Scope	What it does
`models_list`	—	List available models with live INR pricing per 1M tokens; filter with `search`
`model_get`	—	Full detail for one model: pricing, context window, modalities, status
`pricing_estimate`	—	Estimate a request's INR cost from token counts
`docs_search`	—	Search this documentation and get links to relevant pages
`credits_balance`	`wallet:read`	Your current wallet balance in INR
`usage_summary`	`usage:read`	Recent request count, INR spend, and top models (up to 90 days)
`keys_list`	`keys:read`	Your inference API keys (metadata only — never the secret)

The MCP server never routes inference. To send chat/completion requests, point your client's model provider at https://api.aicredits.in/v1 with an sk-live-… inference key.

Example prompts

Once connected, ask your assistant things like:

"Which is the cheapest model on AICredits that handles 128K context?"
"What's my AICredits balance and what did I spend this week?"
"Estimate the cost of 50K input / 2K output tokens on claude-sonnet-4.5"
"List my AICredits API keys and their budgets."

Model recommendations are grounded in live data — the assistant reads current pricing and availability instead of guessing from stale training knowledge.

Notes

Manage or revoke your management keys any time from the Management API page. Full reference: Management API docs.
The server uses MCP streamable HTTP transport; SSE-only legacy clients are not supported.

Connect

Tools

Example prompts

Notes

On this page