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-integrationso supported agents can learn the APIAny workflow.
Quick Start
Run the server directly with npm:
npx -y @apiany-ai/mcp
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
<p align="center"> <img src="assets/readme/install.svg" alt="Install APIAny MCP with npx" width="900"> </p>2. Add APIAny MCP to Your Agent Client
Use this configuration in Claude Code, Cursor, VS Code, or another MCP-compatible client:
<p align="center"> <img src="assets/readme/config.svg" alt="APIAny MCP client configuration" width="900"> </p>{
"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
<p align="center"> <img src="assets/readme/tools.svg" alt="APIAny MCP tool usage in an agent conversation" width="900"> </p>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.
MCP Tools
| 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:
src/server.js: MCP server implementation.examples/mcp.json: client configuration example.docs/distribution.md: release checklist for npm, MCP directories, and skill marketplaces.CHANGELOG.md: release history.
Links
- Website: https://apiany.ai
- GitHub: https://github.com/ailingqu/ApiAny.AI-MCP
- npm: https://www.npmjs.com/package/@apiany-ai/mcp
- Models: https://apiany.ai/models
- Docs context: https://apiany.ai/llms.txt
License
MIT