English Français العربية

io.github.ailingqu/apiany-mcp

Official registry Productivity

APIAny MCP server for model discovery, pricing, docs, and integration examples.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @apiany-ai/mcp
Claude Code 
claude mcp add apiany-mcp -e 'APIANY_BASE_URL=<APIANY_BASE_URL>' -e 'APIANY_API_KEY=<your apiany_api_key>' -- npx -y @apiany-ai/mcp@0.1.2
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "apiany-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@apiany-ai/mcp@0.1.2"
            ],
            "env": {
                "APIANY_BASE_URL": "<APIANY_BASE_URL>",
                "APIANY_API_KEY": "<your apiany_api_key>"
            }
        }
    }
}

Environment variables

  • APIANY_BASE_URL APIAny base URL. Defaults to https://apiany.ai.
  • APIANY_API_KEY secret Optional APIAny API key for paid image/video task tools and task polling.

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. APIAny MCP
  2. What This Repository Provides
  3. Quick Start
  4. Visual Setup
  5. MCP Tools
  6. Agent Skill
  7. Environment Variables
  8. Safety Model
  9. Development
  10. Links
  11. License

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:

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
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.

MCP Tools

ToolPurposeAPI key
list_modelsList public APIAny models with pricing and capability metadata.No
search_modelsSearch models by text, provider, modality, or capability.No
get_modelGet one public model by model id or display name.No
estimate_costEstimate credits from public pricing metadata.No
get_model_usageReturn endpoint, payload, async behavior, and language examples for models.No
get_integration_examplesReturn cURL, Python, JavaScript, Go, Java, or PHP examples.No
get_docs_contextReturn compact APIAny documentation context from /llms.txt.No
create_image_taskCreate a paid async image task after explicit confirmation.Yes
create_video_taskCreate a paid async video task after explicit confirmation.Yes
get_task_statusRead 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

VariableRequiredDescription
APIANY_BASE_URLNoAPIAny base URL. Defaults to https://apiany.ai.
APIANY_API_KEYOnly for paid toolsAPI 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

npm install
npm run check
npx -y @modelcontextprotocol/inspector node src/server.js

Useful files:

License

MIT

Frequently asked questions

What is io.github.ailingqu/apiany-mcp?

APIAny MCP server for model discovery, pricing, docs, and integration examples.

How do I install io.github.ailingqu/apiany-mcp?

It runs on your machine. In Claude Code: claude mcp add apiany-mcp -e 'APIANY_BASE_URL=<APIANY_BASE_URL>' -e 'APIANY_API_KEY=<your apiany_api_key>' -- npx -y @apiany-ai/mcp@0.1.2. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.ailingqu/apiany-mcp need an API key?

Yes. It expects APIANY_API_KEY, which you set in its configuration.

Is io.github.ailingqu/apiany-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.ailingqu/apiany-mcp?

It is published by ailingqu. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.