APIAny MCP
Official MCP server for APIAny model discovery, pricing context, documentation lookup, and OpenAI-compatible integration examples.
APIAny connects agents and developers to 100+ AI models for chat, image, video, and multimodal workflows.
Quick Start ·
Visual Setup ·
MCP Tools ·
Agent Skill ·
Development
English | 中文
What This Repository Provides
APIAny MCP gives AI agents a structured way to understand and use APIAny:
- Discover public APIAny models by provider, modality, capability, and pricing metadata.
- Estimate APIAny credits before choosing a model or running a workflow.
- Fetch compact documentation context from APIAny docs and
llms.txt.
- Generate OpenAI-compatible cURL, Python, JavaScript, Go, Java, and PHP examples.
- Create image or video generation tasks only when an API key is configured and the user explicitly confirms paid usage.
- Package an agent skill at
skills/apiany-integration so supported agents can learn the APIAny workflow.
Quick Start
Run the server directly with npm:
Or install and run it from this repository:
git clone git@github.com:ailingqu/ApiAny.AI-MCP.git
cd ApiAny.AI-MCP
npm install
npm start
Visual Setup
1. Install and Start the MCP Server
2. Add APIAny MCP to Your Agent Client
Use this configuration in Claude Code, Cursor, VS Code, or another MCP-compatible client:
{
"mcpServers": {
"apiany": {
"command": "npx",
"args": ["-y", "@apiany-ai/mcp"],
"env": {
"APIANY_BASE_URL": "https://apiany.ai"
}
}
}
}
For paid image or video task tools, also set APIANY_API_KEY:
{
"APIANY_BASE_URL": "https://apiany.ai",
"APIANY_API_KEY": "your_apiany_api_key"
}
3. Ask Your Agent to Use APIAny
Example prompts:
Use APIAny MCP to find an image model for product photos, compare pricing, and show JavaScript integration code.
Use APIAny MCP to estimate credits for 20 gpt-style chat requests with 10k input tokens and 5k output tokens.
Use APIAny MCP to show JavaScript usage for nano-banana-pro and Python usage for veo3-1-fast.
| Tool | Purpose | API key |
|---|
list_models | List public APIAny models with pricing and capability metadata. | No |
search_models | Search models by text, provider, modality, or capability. | No |
get_model | Get one public model by model id or display name. | No |
estimate_cost | Estimate credits from public pricing metadata. | No |
get_model_usage | Return endpoint, payload, async behavior, and language examples for models. | No |
get_integration_examples | Return cURL, Python, JavaScript, Go, Java, or PHP examples. | No |
get_docs_context | Return compact APIAny documentation context from /llms.txt. | No |
create_image_task | Create a paid async image task after explicit confirmation. | Yes |
create_video_task | Create a paid async video task after explicit confirmation. | Yes |
get_task_status | Read async media task status. | Yes |
Agent Skill
The APIAny Integration skill lives in skills/apiany-integration.
It helps agents:
- Choose APIAny models by modality, provider, pricing, and capability.
- Generate examples for chat, image, video, and media workflows.
- Explain async task creation and polling.
- Require explicit confirmation before paid generation tasks.
Environment Variables
| Variable | Required | Description |
|---|
APIANY_BASE_URL | No | APIAny base URL. Defaults to https://apiany.ai. |
APIANY_API_KEY | Only for paid tools | API key used for paid image/video task creation and task polling. |
Safety Model
Read-only tools work without an API key. Paid generation tools require both:
APIANY_API_KEYconfirm_paid_request=true
The server does not persist API keys. It only reads them from the current process environment.
Development
npm install
npm run check
npx -y @modelcontextprotocol/inspector node src/server.js
Useful files:
Links
License
MIT