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 | 中文

APIAny MCP overview

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:

Terminal

npx -y @apiany-ai/mcp

Or install and run it from this repository:

bash

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

Install APIAny MCP with npx

2. Add APIAny MCP to Your Agent Client

Use this configuration in Claude Code, Cursor, VS Code, or another MCP-compatible client:

APIAny MCP client configuration

config.json

{
  "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:

config.json

{
  "APIANY_BASE_URL": "https://apiany.ai",
  "APIANY_API_KEY": "your_apiany_api_key"
}

3. Ask Your Agent to Use APIAny

APIAny MCP tool usage in an agent conversation

Example prompts:

text

Use APIAny MCP to find an image model for product photos, compare pricing, and show JavaScript integration code.

text

Use APIAny MCP to estimate credits for 20 gpt-style chat requests with 10k input tokens and 5k output tokens.

text

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_KEY
confirm_paid_request=true

The server does not persist API keys. It only reads them from the current process environment.

Development

Terminal

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.

License

MIT

Apiany MCP README

APIAny MCP

What This Repository Provides

Quick Start

Visual Setup

1. Install and Start the MCP Server

2. Add APIAny MCP to Your Agent Client

3. Ask Your Agent to Use APIAny

MCP Tools

Agent Skill

Environment Variables

Safety Model

Development

Links

License