Skip to main content
Glama

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.

Related MCP server: ask-another

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

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

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

Useful files:

License

MIT

Available Tools

10 tools
create_image_taskC

Create a paid APIAny asynchronous image generation task. Requires APIANY_API_KEY and confirm_paid_request=true.

Inputs: model (required), prompt (required), size, quality, +4 more.

create_video_taskC

Create a paid APIAny asynchronous video generation task. Requires APIANY_API_KEY and confirm_paid_request=true.

Inputs: model (required), prompt (required), duration, aspect_ratio, +7 more.

estimate_costC

Estimate APIAny credits for a model using public pricing metadata.

Inputs: model (required), requests, input_tokens, output_tokens, +1 more.

get_docs_contextC

Return compact APIAny documentation context from llms.txt.

Inputs: max_chars.

get_integration_examplesB

Return APIAny integration examples for a model and language.

Inputs: language, model.

get_modelA

Get one APIAny model by public model id or display name.

Inputs: model (required).

get_model_usageC

Return endpoint, payload, async behavior, and language example for one or more APIAny models.

Inputs: model, type, language, limit.

get_task_statusC

Get an APIAny async generation task status. Requires APIANY_API_KEY.

Inputs: task_id (required).

list_modelsC

List public APIAny models with pricing and capability metadata.

Inputs: q, type, provider, limit.

search_modelsC

Search APIAny models by natural-language text, provider, modality, or capability.

Inputs: query (required), type, limit.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 10 tools

    Disambiguation5/5

    All tools have clearly distinct purposes: image/video task creation, cost estimation, documentation retrieval, model lookup, usage examples, task status, listing, and searching. No overlap is evident.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern with underscores (e.g., create_image_task, list_models). Verbs like create, get, list, search are used uniformly, and naming conventions are fully consistent.

    Tool Count5/5

    With 10 tools, the set is well-scoped for an API abstraction layer. It covers discovery (list, search), details (get_model, get_model_usage), cost estimation, task creation (image/video), status checking, and documentation—each tool earns its place.

    Completeness4/5

    The tool surface covers key workflows: model discovery, cost estimation, async task creation and status checking. Minor gaps include lack of task cancellation or listing, but these are non-essential for core usage, so it's nearly complete.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      F
      maintenance
      Provides AI assistants with real-time access to 1000+ AI models including their latest pricing, context windows, capabilities, and specifications. Supports model search, comparison, recommendations, and live testing.
      3
      1
      MIT
    • -
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables discovery of public AI models with pricing, documentation context, and OpenAI-compatible integration examples. Supports both read-only queries and paid async media generation tasks.
      -