Find and compare AI models, run chat, embeddings, image, video and audio generation, and call Agent Tools such as web search and page extraction.
This repository holds install manifests only. The server is hosted by AI/ML API; there is no server code here and nothing to build or run locally.
| Endpoint | https://mcp.aimlapi.com/mcp |
| Transport | Streamable HTTP |
| Auth | OAuth sign-in, or Authorization: Bearer <API key> |
| Official MCP Registry | com.aimlapi/mcp |
| Docs | https://docs.aimlapi.com/quickstart/mcp |
| API keys | https://aimlapi.com/app/keys |
| Privacy policy | https://aimlapi.com/privacy-policy |
| Terms of service | https://aimlapi.com/terms-and-conditions |
| Support | help@aimlapi.com |
Pick one.
OAuth (default, no key in any file). The manifests in this repo add the server by URL only. On first use the client gets a 401 that points to the server's OAuth metadata, registers itself (dynamic client registration), and opens a browser sign-in to your AI/ML API account (PKCE). Scopes: openid email offline_access mcp:invoke.
API key. Create a key at https://aimlapi.com/app/keys and add the server with an Authorization header (commands below). Replace YOUR_AIMLAPI_API_KEY with your key, and do not commit a config file that contains it. When the header is set, no OAuth sign-in happens.
Plugin (OAuth):
claude plugin marketplace add aimlapi/mcp
claude plugin install aimlapi@aimlapiThen run /mcp in Claude Code, select plugin:aimlapi:aimlapi and choose Authenticate.
API key instead of the plugin:
claude mcp add-json -s user aimlapi '{"type":"http","url":"https://mcp.aimlapi.com/mcp","headers":{"Authorization":"Bearer YOUR_AIMLAPI_API_KEY"}}'Use one or the other. When a server with the same URL is configured by hand, Claude Code hides the plugin's copy.
Extension (OAuth):
gemini extensions install https://github.com/aimlapi/mcpThen run /mcp auth aimlapi in Gemini CLI.
API key:
gemini mcp add -s user -t http -H 'Authorization: Bearer YOUR_AIMLAPI_API_KEY' aimlapi https://mcp.aimlapi.com/mcpExtension (OAuth):
qwen extensions install aimlapi/mcp:aimlapiThen run /mcp in Qwen Code and authenticate aimlapi. Installing with the plain repo URL also works; Qwen Code then asks you to pick the aimlapi plugin.
API key:
qwen mcp add -s user --transport http -H 'Authorization: Bearer YOUR_AIMLAPI_API_KEY' aimlapi https://mcp.aimlapi.com/mcpPlugin (OAuth):
qoder plugins marketplace add aimlapi/mcp
qoder plugins install aimlapi@aimlapiAPI key:
qoder mcp add -s user --transport http aimlapi https://mcp.aimlapi.com/mcp -H 'Authorization: Bearer YOUR_AIMLAPI_API_KEY'Cline: see llms-install.md. Any client that supports remote Streamable HTTP MCP servers can use the URL above with either auth option.
Ask the agent to call ping (returns pong), then account_balance. Both are free.
25 tools. Catalog, account and job-status tools are free. Model calls, tools_run and the two ranked searches are billed to your AI/ML API balance at the listed price; check prices with model_get or tools_inspect first.
| Tool | What it does |
|---|---|
ping |
connectivity check |
account_balance |
account balance |
account_usage |
spending and key limit |
models_list |
browse the model catalog |
models_search |
search models by keyword |
model_get |
one model: capabilities, prices, metrics |
models_compare |
compare 2 to 10 models |
models_find_best |
cheapest or fastest model for a modality |
tools_search |
search the Agent Tools catalog |
tools_inspect |
one Agent Tool: input schema, price, health |
tools_run_status |
status of an Agent Tool run |
job_status |
status of a generation job |
job_result |
output of a generation job |
| Tool | What it does |
|---|---|
jev_model_search |
AI-ranked model search (about $0.002 per search) |
jev_tool_search |
AI-ranked Agent Tools search (about $0.002 per search) |
llm_chat |
chat completion with any language model |
embeddings_create |
text embeddings |
image_generate |
image generation |
image_edit |
image editing |
video_generate |
video generation |
audio_generate |
music generation |
speech_generate |
text to speech |
speech_transcribe |
speech to text |
document_ocr |
document OCR |
tools_run |
run an Agent Tool, such as web search or page extraction |
| File | Used by |
|---|---|
.claude-plugin/plugin.json, .claude-plugin/marketplace.json |
Claude Code plugin and marketplace |
.qoder-plugin/plugin.json, .mcp.json |
Qoder plugin (Claude Code also reads .mcp.json) |
gemini-extension.json |
Gemini CLI extension |
qwen-extension.json |
Qwen Code extension |
llms-install.md |
install steps for Cline and other agents |
Apache-2.0. See LICENSE.