{ "markdown": "

APIAny MCP

\n\n

\n Official MCP server for APIAny model discovery, pricing context, documentation lookup, and OpenAI-compatible integration examples.\n

\n\n

\n APIAny connects agents and developers to 100+ AI models for chat, image, video, and multimodal workflows.\n

\n\n

\n \"npm\n \"npm\n \"release\"\n \"license\"\n \"Node.js\"\n \"MCP\n

\n\n

\n Quick Start ·\n Visual Setup ·\n MCP Tools ·\n Agent Skill ·\n Development\n

\n\n

\n English | 中文\n

\n\n

\n \"APIAny\n

\n\n## What This Repository Provides\n\nAPIAny MCP gives AI agents a structured way to understand and use [APIAny](https://apiany.ai):\n\n- Discover public APIAny models by provider, modality, capability, and pricing metadata.\n- Estimate APIAny credits before choosing a model or running a workflow.\n- Fetch compact documentation context from APIAny docs and `llms.txt`.\n- Generate OpenAI-compatible cURL, Python, JavaScript, Go, Java, and PHP examples.\n- Create image or video generation tasks only when an API key is configured and the user explicitly confirms paid usage.\n- Package an agent skill at `skills/apiany-integration` so supported agents can learn the APIAny workflow.\n\n## Quick Start\n\nRun the server directly with npm:\n\n```bash\nnpx -y @apiany-ai/mcp\n```\n\nOr install and run it from this repository:\n\n```bash\ngit clone git@github.com:ailingqu/ApiAny.AI-MCP.git\ncd ApiAny.AI-MCP\nnpm install\nnpm start\n```\n\n## Visual Setup\n\n### 1. Install and Start the MCP Server\n\n

\n \"Install\n

\n\n### 2. Add APIAny MCP to Your Agent Client\n\nUse this configuration in Claude Code, Cursor, VS Code, or another MCP-compatible client:\n\n

\n \"APIAny\n

\n\n```json\n{\n \"mcpServers\": {\n \"apiany\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@apiany-ai/mcp\"],\n \"env\": {\n \"APIANY_BASE_URL\": \"https://apiany.ai\"\n }\n }\n }\n}\n```\n\nFor paid image or video task tools, also set `APIANY_API_KEY`:\n\n```json\n{\n \"APIANY_BASE_URL\": \"https://apiany.ai\",\n \"APIANY_API_KEY\": \"your_apiany_api_key\"\n}\n```\n\n### 3. Ask Your Agent to Use APIAny\n\n

\n \"APIAny\n

\n\nExample prompts:\n\n```text\nUse APIAny MCP to find an image model for product photos, compare pricing, and show JavaScript integration code.\n```\n\n```text\nUse APIAny MCP to estimate credits for 20 gpt-style chat requests with 10k input tokens and 5k output tokens.\n```\n\n```text\nUse APIAny MCP to show JavaScript usage for nano-banana-pro and Python usage for veo3-1-fast.\n```\n\n## MCP Tools\n\n| Tool | Purpose | API key |\n| --- | --- | --- |\n| `list_models` | List public APIAny models with pricing and capability metadata. | No |\n| `search_models` | Search models by text, provider, modality, or capability. | No |\n| `get_model` | Get one public model by model id or display name. | No |\n| `estimate_cost` | Estimate credits from public pricing metadata. | No |\n| `get_model_usage` | Return endpoint, payload, async behavior, and language examples for models. | No |\n| `get_integration_examples` | Return cURL, Python, JavaScript, Go, Java, or PHP examples. | No |\n| `get_docs_context` | Return compact APIAny documentation context from `/llms.txt`. | No |\n| `create_image_task` | Create a paid async image task after explicit confirmation. | Yes |\n| `create_video_task` | Create a paid async video task after explicit confirmation. | Yes |\n| `get_task_status` | Read async media task status. | Yes |\n\n## Agent Skill\n\nThe APIAny Integration skill lives in [`skills/apiany-integration`](skills/apiany-integration).\n\nIt helps agents:\n\n- Choose APIAny models by modality, provider, pricing, and capability.\n- Generate examples for chat, image, video, and media workflows.\n- Explain async task creation and polling.\n- Require explicit confirmation before paid generation tasks.\n\n## Environment Variables\n\n| Variable | Required | Description |\n| --- | --- | --- |\n| `APIANY_BASE_URL` | No | APIAny base URL. Defaults to `https://apiany.ai`. |\n| `APIANY_API_KEY` | Only for paid tools | API key used for paid image/video task creation and task polling. |\n\n## Safety Model\n\nRead-only tools work without an API key. Paid generation tools require both:\n\n- `APIANY_API_KEY`\n- `confirm_paid_request=true`\n\nThe server does not persist API keys. It only reads them from the current process environment.\n\n## Development\n\n```bash\nnpm install\nnpm run check\nnpx -y @modelcontextprotocol/inspector node src/server.js\n```\n\nUseful files:\n\n- [`src/server.js`](src/server.js): MCP server implementation.\n- [`examples/mcp.json`](examples/mcp.json): client configuration example.\n- [`docs/distribution.md`](docs/distribution.md): release checklist for npm, MCP directories, and skill marketplaces.\n- [`CHANGELOG.md`](CHANGELOG.md): release history.\n\n## Links\n\n- Website: [https://apiany.ai](https://apiany.ai)\n- GitHub: [https://github.com/ailingqu/ApiAny.AI-MCP](https://github.com/ailingqu/ApiAny.AI-MCP)\n- npm: [https://www.npmjs.com/package/@apiany-ai/mcp](https://www.npmjs.com/package/@apiany-ai/mcp)\n- Models: [https://apiany.ai/models](https://apiany.ai/models)\n- Docs context: [https://apiany.ai/llms.txt](https://apiany.ai/llms.txt)\n\n## License\n\nMIT\n", "bytes": 6550, "sha": "4a8af1a201f417bbee8e90607357f09e2e8af25fec14a23971980ce8f58be8ac", "repo_slug": "ailingqu/apiany.ai-mcp", "fonte": "repo", "truncated": false, "api": "https://agentalog.com/api/listings/mcp_io_github_ailingqu_apiany_mcp_3a2f8cbc/readme" }