{"_id":"@apitreedev/mcp-server","_rev":"6-3a81cbb3dea1342384535ae6d6784a72","name":"@apitreedev/mcp-server","dist-tags":{"latest":"0.3.5"},"versions":{"0.3.0":{"name":"@apitreedev/mcp-server","version":"0.3.0","keywords":["mcp","model-context-protocol","apitree","api-marketplace","ai-agent","claude","cursor","windsurf","remote-mcp","api-proxy","korea"],"license":"MIT","_id":"@apitreedev/mcp-server@0.3.0","maintainers":[{"name":"apitree-dev","email":"dev@apitree.ai"}],"homepage":"https://github.com/ApitreeDev/nexus#readme","bugs":{"url":"https://github.com/ApitreeDev/nexus/issues"},"bin":{"apitree-mcp":"dist/index.js"},"dist":{"shasum":"d10eb87c0e503f453ef9c6da9c777bc55b7be704","tarball":"https://registry.npmjs.org/@apitreedev/mcp-server/-/mcp-server-0.3.0.tgz","fileCount":23,"integrity":"sha512-lMUqQNJ9I1Mrm8ZrVVrjhuVYtm3O986zJWJZMqBFSVvuT3IEUhemgUV4e16JwSVpxYfbjhI2VJtRzAS8IABGUg==","signatures":[{"sig":"MEQCID1nHQLL3IxIF+kJmyWin8uYuuzok+HQ/TZiVFiDnhdUAiBK2Sbdh6VkDQwKeo9tjWau/5ls2QzyKJw0y8cCuuDg8g==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":119501},"type":"module","gitHead":"1e688eb7c5fdfd76df714cbb27b68c9fbb801627","scripts":{"dev":"tsx watch src/index.ts","test":"vitest run","build":"tsc","typecheck":"tsc --noEmit","publish:npm":"npm publish --access public","prepublishOnly":"pnpm build"},"_npmUser":{"name":"apitree-dev","email":"dev@apitree.ai"},"repository":{"url":"git+https://github.com/ApitreeDev/nexus.git","type":"git","directory":"packages/mcp-server"},"_npmVersion":"11.9.0","description":"apitree MCP Server — one connection to 1,980+ APIs. Search, call, batch, compare, forecast via Model Context Protocol. Includes Remote MCP at https://apitree.ai/api/mcp","directories":{},"_nodeVersion":"25.5.0","dependencies":{"zod":"^3.23.0","@modelcontextprotocol/sdk":"^1.11.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.0","vitest":"^4.1.4","typescript":"^5.5.0","@types/node":"^20.0.0","@apitree/tsconfig":"workspace:*"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.3.0_1783997340025_0.4481660794875153","host":"s3://npm-registry-packages-npm-production"}},"0.3.1":{"name":"@apitreedev/mcp-server","version":"0.3.1","keywords":["mcp","model-context-protocol","apitree","api-marketplace","ai-agent","claude","cursor","windsurf","remote-mcp","api-proxy","korea"],"license":"MIT","_id":"@apitreedev/mcp-server@0.3.1","maintainers":[{"name":"apitree-dev","email":"dev@apitree.ai"}],"homepage":"https://github.com/ApitreeDev/nexus#readme","bugs":{"url":"https://github.com/ApitreeDev/nexus/issues"},"bin":{"apitree-mcp":"dist/index.js"},"dist":{"shasum":"041f86bbbc2af89f1c02c6f00464034c7efe61bc","tarball":"https://registry.npmjs.org/@apitreedev/mcp-server/-/mcp-server-0.3.1.tgz","fileCount":23,"integrity":"sha512-K35kesafgRTUjDICUnB7WoJfKNWGwj9v0Adf8/VYO/UGhI8rNUmN/B/YcpUlqoVVCC/phht7mfHldfLklXioiQ==","signatures":[{"sig":"MEUCIQCurVqka4VQ7QiOVOGvPoor7P3W3NhNP1g/gZ6CeGTa5wIgC0y02eP4ByO4nfk0BhZ9DPPAZMRFRHZbr0+jT2hGpa8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":124989},"type":"module","_from":"file:apitreedev-mcp-server-0.3.1.tgz","scripts":{"dev":"tsx watch src/index.ts","test":"vitest run","build":"tsc","typecheck":"tsc --noEmit","publish:npm":"npm publish --access public"},"_npmUser":{"name":"apitree-dev","email":"dev@apitree.ai"},"_resolved":"/tmp/19c0df216895a67331e5749d490e67b1/apitreedev-mcp-server-0.3.1.tgz","_integrity":"sha512-K35kesafgRTUjDICUnB7WoJfKNWGwj9v0Adf8/VYO/UGhI8rNUmN/B/YcpUlqoVVCC/phht7mfHldfLklXioiQ==","repository":{"url":"git+https://github.com/ApitreeDev/nexus.git","type":"git","directory":"packages/mcp-server"},"_npmVersion":"10.9.8","description":"apitree MCP Server — one connection to 1,980+ APIs. Search, call, batch, compare, forecast via Model Context Protocol. Includes Remote MCP at https://apitree.ai/api/mcp","directories":{},"_nodeVersion":"22.23.1","dependencies":{"zod":"^3.23.0","@modelcontextprotocol/sdk":"^1.11.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.0","vitest":"^4.1.4","typescript":"^5.5.0","@types/node":"^20.0.0","@apitree/tsconfig":"0.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.3.1_1786021730764_0.880939824169612","host":"s3://npm-registry-packages-npm-production"}},"0.3.2":{"name":"@apitreedev/mcp-server","version":"0.3.2","keywords":["mcp","model-context-protocol","apitree","api-marketplace","ai-agent","claude","cursor","windsurf","remote-mcp","api-proxy","korea"],"license":"MIT","_id":"@apitreedev/mcp-server@0.3.2","maintainers":[{"name":"apitree-dev","email":"dev@apitree.ai"}],"homepage":"https://github.com/ApitreeDev/nexus#readme","bugs":{"url":"https://github.com/ApitreeDev/nexus/issues"},"bin":{"apitree-mcp":"dist/index.js"},"dist":{"shasum":"884c42d824d0c8d37aa0b5e32dc95226b932d46c","tarball":"https://registry.npmjs.org/@apitreedev/mcp-server/-/mcp-server-0.3.2.tgz","fileCount":23,"integrity":"sha512-Ql+1Cbe9bLYXkR/dY0stvDVM+DFH1Ad4Z0rFhZhTwqQpdmDSgBPn1HAiHSjy8KrqBrbkwKWJG0GX+3fUQki85w==","signatures":[{"sig":"MEUCIHApyalQWAFkGCrZoez8D8Hoo2T5Xcqoy3IOAmLODGX0AiEA75uqAkY/DXFlnFySkysCvPaXt3msZ7/jht7INxxhZUY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":125301},"type":"module","_from":"file:apitreedev-mcp-server-0.3.2.tgz","scripts":{"dev":"tsx watch src/index.ts","test":"vitest run","build":"tsc","typecheck":"tsc --noEmit","publish:npm":"npm publish --access public"},"_npmUser":{"name":"apitree-dev","email":"dev@apitree.ai"},"_resolved":"/tmp/c899b57fdfe0c42e858e7d14fe80f66b/apitreedev-mcp-server-0.3.2.tgz","_integrity":"sha512-Ql+1Cbe9bLYXkR/dY0stvDVM+DFH1Ad4Z0rFhZhTwqQpdmDSgBPn1HAiHSjy8KrqBrbkwKWJG0GX+3fUQki85w==","repository":{"url":"git+https://github.com/ApitreeDev/nexus.git","type":"git","directory":"packages/mcp-server"},"_npmVersion":"10.9.8","description":"apitree MCP Server — one connection to 1,980+ APIs. Search, call, batch, compare, forecast via Model Context Protocol. Includes Remote MCP at https://apitree.ai/api/mcp","directories":{},"_nodeVersion":"22.23.1","dependencies":{"zod":"^3.23.0","@modelcontextprotocol/sdk":"^1.11.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.0","vitest":"^4.1.4","typescript":"^5.5.0","@types/node":"^20.0.0","@apitree/tsconfig":"0.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.3.2_1786023157147_0.6444344263009707","host":"s3://npm-registry-packages-npm-production"}},"0.3.3":{"name":"@apitreedev/mcp-server","version":"0.3.3","keywords":["mcp","model-context-protocol","apitree","api-marketplace","ai-agent","claude","cursor","windsurf","remote-mcp","api-proxy","korea"],"license":"MIT","_id":"@apitreedev/mcp-server@0.3.3","maintainers":[{"name":"apitree-dev","email":"dev@apitree.ai"}],"homepage":"https://github.com/ApitreeDev/nexus#readme","bugs":{"url":"https://github.com/ApitreeDev/nexus/issues"},"bin":{"apitree-mcp":"dist/index.js"},"dist":{"shasum":"4a4fe82ac96b7ac5f330db222a35bdbafb141ed8","tarball":"https://registry.npmjs.org/@apitreedev/mcp-server/-/mcp-server-0.3.3.tgz","fileCount":23,"integrity":"sha512-eZESnc9wZuvVWDTGd8fyak2knBQIBMrqx0ajInGaZGxLPRBKqrMkxxvLylFUpGuXaGZ8FGJ+j9pwoUA+tw3X+w==","signatures":[{"sig":"MEUCIQCjBq2IhCKYb7bSfwUeYFaSkOKR+6uZWIwxwfh9MNQhYgIgZIAQmtNYtttSqHhfzfY+GMID+zi2JWaXhOostukjgj8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":131178},"type":"module","_from":"file:apitreedev-mcp-server-0.3.3.tgz","scripts":{"dev":"tsx watch src/index.ts","test":"vitest run","build":"tsc","typecheck":"tsc --noEmit","publish:npm":"npm publish --access public"},"_npmUser":{"name":"apitree-dev","email":"dev@apitree.ai"},"_resolved":"/tmp/f2c28864f84188361b232c0c9ffb3ab7/apitreedev-mcp-server-0.3.3.tgz","_integrity":"sha512-eZESnc9wZuvVWDTGd8fyak2knBQIBMrqx0ajInGaZGxLPRBKqrMkxxvLylFUpGuXaGZ8FGJ+j9pwoUA+tw3X+w==","repository":{"url":"git+https://github.com/ApitreeDev/nexus.git","type":"git","directory":"packages/mcp-server"},"_npmVersion":"10.9.8","description":"apitree MCP Server — one connection to the whole API catalog. Search, call, batch, compare, forecast via Model Context Protocol. Includes Remote MCP at https://apitree.ai/api/mcp","directories":{},"_nodeVersion":"22.23.2","dependencies":{"zod":"^3.23.0","@modelcontextprotocol/sdk":"^1.11.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.0","vitest":"^4.1.4","typescript":"^5.5.0","@types/node":"^20.0.0","@apitree/tsconfig":"0.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.3.3_1787298936116_0.5252036184906779","host":"s3://npm-registry-packages-npm-production"}},"0.3.4":{"name":"@apitreedev/mcp-server","version":"0.3.4","keywords":["mcp","model-context-protocol","apitree","api-marketplace","ai-agent","claude","cursor","windsurf","remote-mcp","api-proxy","korea"],"license":"MIT","_id":"@apitreedev/mcp-server@0.3.4","maintainers":[{"name":"apitree-dev","email":"dev@apitree.ai"}],"homepage":"https://github.com/ApitreeDev/nexus#readme","bugs":{"url":"https://github.com/ApitreeDev/nexus/issues"},"bin":{"apitree-mcp":"dist/index.js"},"dist":{"shasum":"7587c3165af64e928ce4687141884cbadb8cdcc2","tarball":"https://registry.npmjs.org/@apitreedev/mcp-server/-/mcp-server-0.3.4.tgz","fileCount":23,"integrity":"sha512-6fV6rn4DFD+Lr0kf/9rvcH3Tyb1QLiDQvj5aHGwbBHsDRl+H9jx9BUQkvTGyxCjEPDQ/roWvyrOtVUIMUeKVfA==","signatures":[{"sig":"MEUCIAu1jtxyWtJHWX+XZrHLkp6sK7R3e9Cz56efDILT8mANAiEAr9cZT4OWU+h8nd5IHDayEre68+Haj+lwWAk/rcGnoMU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":137189},"type":"module","_from":"file:apitreedev-mcp-server-0.3.4.tgz","scripts":{"dev":"tsx watch src/index.ts","test":"vitest run","build":"tsc","typecheck":"tsc -p tsconfig.typecheck.json","publish:npm":"npm publish --access public"},"_npmUser":{"name":"apitree-dev","email":"dev@apitree.ai"},"_resolved":"/tmp/5123c9dd0380d10f73d9f9ada3f3b13d/apitreedev-mcp-server-0.3.4.tgz","_integrity":"sha512-6fV6rn4DFD+Lr0kf/9rvcH3Tyb1QLiDQvj5aHGwbBHsDRl+H9jx9BUQkvTGyxCjEPDQ/roWvyrOtVUIMUeKVfA==","repository":{"url":"git+https://github.com/ApitreeDev/nexus.git","type":"git","directory":"packages/mcp-server"},"_npmVersion":"10.9.8","description":"apitree MCP Server — one connection to the whole API catalog. Search, call, batch, compare, forecast via Model Context Protocol. Includes Remote MCP at https://apitree.ai/api/mcp","directories":{},"_nodeVersion":"22.23.2","dependencies":{"zod":"^3.23.0","@modelcontextprotocol/sdk":"^1.11.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.0","vitest":"^4.1.4","typescript":"^5.5.0","@types/node":"^20.0.0","@apitree/tsconfig":"0.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.3.4_1787913161723_0.5679713371788186","host":"s3://npm-registry-packages-npm-production"}},"0.3.5":{"name":"@apitreedev/mcp-server","version":"0.3.5","description":"apitree MCP Server — one connection to the whole API catalog. Search, call, batch, compare, forecast via Model Context Protocol. Includes Remote MCP at https://apitree.ai/api/mcp","type":"module","bin":{"apitree-mcp":"dist/index.js"},"keywords":["mcp","model-context-protocol","apitree","api-marketplace","ai-agent","claude","cursor","windsurf","remote-mcp","api-proxy","korea"],"license":"MIT","publishConfig":{"access":"public"},"repository":{"type":"git","url":"git+https://github.com/ApitreeDev/nexus.git","directory":"packages/mcp-server"},"dependencies":{"@modelcontextprotocol/sdk":"^1.11.0","zod":"^3.23.0"},"devDependencies":{"@types/node":"^20.0.0","tsx":"^4.19.0","typescript":"^5.5.0","vitest":"^4.1.4","@apitree/tsconfig":"0.0.0"},"scripts":{"dev":"tsx watch src/index.ts","build":"tsc","typecheck":"tsc -p tsconfig.typecheck.json","test":"vitest run","publish:npm":"npm publish --access public"},"_id":"@apitreedev/mcp-server@0.3.5","bugs":{"url":"https://github.com/ApitreeDev/nexus/issues"},"homepage":"https://github.com/ApitreeDev/nexus#readme","_integrity":"sha512-WqyF8aMLWZGdhjpYiDSB+rdSOoS9GJE1otyqm7vlCeG1QGMmtp2ea6dGpelZgFwChhgyMm3v9X7RTguqnanqjQ==","_resolved":"/tmp/c6bc7fea5d7c5745e80a34d9caa8f7fe/apitreedev-mcp-server-0.3.5.tgz","_from":"file:apitreedev-mcp-server-0.3.5.tgz","_nodeVersion":"22.23.2","_npmVersion":"10.9.8","dist":{"integrity":"sha512-WqyF8aMLWZGdhjpYiDSB+rdSOoS9GJE1otyqm7vlCeG1QGMmtp2ea6dGpelZgFwChhgyMm3v9X7RTguqnanqjQ==","shasum":"a481c39c8d0806c6ff0121b85b4023df77d75bc7","tarball":"https://registry.npmjs.org/@apitreedev/mcp-server/-/mcp-server-0.3.5.tgz","fileCount":23,"unpackedSize":143193,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIAi0PVrc1glpr8KlGTOcTpsMJ+UDWCiq2lOkJ0B8EDdiAiAgvG3QfvuK1d0UA53mRfCvH4FSnwry/MvTMva22XN2vA=="}]},"_npmUser":{"name":"apitree-dev","email":"dev@apitree.ai"},"directories":{},"maintainers":[{"name":"apitree-dev","email":"dev@apitree.ai"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server_0.3.5_1787972718397_0.8708961119053424"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-14T02:48:59.880Z","modified":"2026-08-29T03:05:18.702Z","0.3.0":"2026-07-14T02:49:00.185Z","0.3.1":"2026-08-06T13:08:50.950Z","0.3.2":"2026-08-06T13:32:37.327Z","0.3.3":"2026-08-21T07:55:36.257Z","0.3.4":"2026-08-28T10:32:41.873Z","0.3.5":"2026-08-29T03:05:18.532Z"},"bugs":{"url":"https://github.com/ApitreeDev/nexus/issues"},"license":"MIT","homepage":"https://github.com/ApitreeDev/nexus#readme","keywords":["mcp","model-context-protocol","apitree","api-marketplace","ai-agent","claude","cursor","windsurf","remote-mcp","api-proxy","korea"],"repository":{"type":"git","url":"git+https://github.com/ApitreeDev/nexus.git","directory":"packages/mcp-server"},"description":"apitree MCP Server — one connection to the whole API catalog. Search, call, batch, compare, forecast via Model Context Protocol. Includes Remote MCP at https://apitree.ai/api/mcp","maintainers":[{"name":"apitree-dev","email":"dev@apitree.ai"}],"readme":"# @apitreedev/mcp-server\n\n> **apitree** — AI-Native API Marketplace. One connection, the whole catalog.\n\nAI Agents (Claude, Cursor, Windsurf, etc.) discover and call real-world APIs automatically through the Model Context Protocol — no per-API integrations, no key management per provider.\n\n[![npm version](https://img.shields.io/npm/v/@apitreedev/mcp-server)](https://www.npmjs.com/package/@apitreedev/mcp-server)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n[![MCP](https://img.shields.io/badge/MCP-Streamable%20HTTP-green)](https://apitree.ai/api/mcp)\n\n---\n\n## Connect — two ways\n\n### Option A: Remote MCP (recommended — no install)\n\nConnect directly via URL. No `npm install`, no local process, no updates needed.\n\n**Claude Code:**\n```bash\n# OAuth click-to-connect (recommended) — run /mcp inside Claude Code and\n# pick \"Authenticate\" to sign in via the browser. No API key needed.\nclaude mcp add --transport http apitree https://apitree.ai/api/mcp\n\n# Or with an API key header — for CI and non-interactive environments\nclaude mcp add --transport http apitree https://apitree.ai/api/mcp \\\n  --header \"Authorization: Bearer nxs_live_...\"\n```\n\n> The Remote MCP requires authentication. Clients that support MCP OAuth\n> (claude.ai connectors, ChatGPT developer mode, Claude Code, …) can connect\n> with just the URL — the server advertises OAuth 2.1 metadata and supports\n> dynamic client registration. Header-based API keys work everywhere else.\n\n**Claude Desktop** — add to `claude_desktop_config.json`:\n```json\n{\n  \"mcpServers\": {\n    \"apitree\": {\n      \"url\": \"https://apitree.ai/api/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer nxs_live_...\"\n      }\n    }\n  }\n}\n```\n\n**Cursor** — add to `.cursor/mcp.json`:\n```json\n{\n  \"mcpServers\": {\n    \"apitree\": {\n      \"url\": \"https://apitree.ai/api/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer nxs_live_...\"\n      }\n    }\n  }\n}\n```\n\n**Windsurf** — add to `~/.codeium/windsurf/mcp_config.json`:\n```json\n{\n  \"mcpServers\": {\n    \"apitree\": {\n      \"serverUrl\": \"https://apitree.ai/api/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer nxs_live_...\"\n      }\n    }\n  }\n}\n```\n\n---\n\n### Option B: Local stdio (npm install)\n\nRuns as a local process. Works with clients that don't yet support Remote MCP.\n\n**Claude Code:**\n```bash\nclaude mcp add apitree -- npx -y @apitreedev/mcp-server\n```\n\n**Claude Desktop** — add to `claude_desktop_config.json`:\n```json\n{\n  \"mcpServers\": {\n    \"apitree\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@apitreedev/mcp-server\"]\n    }\n  }\n}\n```\n\n**Cursor** — add to `.cursor/mcp.json`:\n```json\n{\n  \"mcpServers\": {\n    \"apitree\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@apitreedev/mcp-server\"]\n    }\n  }\n}\n```\n\n**With API key** (environment variable):\n```json\n{\n  \"mcpServers\": {\n    \"apitree\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@apitreedev/mcp-server\"],\n      \"env\": {\n        \"APITREE_API_KEY\": \"nxs_live_...\"\n      }\n    }\n  }\n}\n```\n\n---\n\n## Authentication\n\nGet a free API key at [apitree.ai/signup](https://apitree.ai/signup) — no credit card required.\n\nFree tier: **100 credits / 30 days**.\n\n| Mode | What's needed |\n|------|---------------|\n| Remote MCP | OAuth 2.1 click-to-connect (no key), or `Authorization: Bearer nxs_live_...` header |\n| Local stdio | `APITREE_API_KEY=nxs_live_...` env var |\n\nOn the local stdio server, every keyed tool also accepts an optional `apitree_token`\nparameter; when provided it takes precedence over `APITREE_API_KEY`.\n\n**Authentication & scopes:**\n\nThe Remote MCP requires authentication for every tool. With OAuth, tools are gated by\nthe scopes granted at consent; an API key unlocks all scopes. On the local stdio server,\ndiscovery tools work without a key and keyed tools need `APITREE_API_KEY`.\n\n| OAuth scope | Tools |\n|-------------|-------|\n| `catalog.read` | `search_apis`, `get_api_details`, `compare_apis`, `list_capabilities`, `top_healthy_apis`, `trending_by_tag`, `recommend_apis`, `estimate_cost`, `get_system_health`, `get_active_incidents` |\n| `apis.call` | `read_api`, `call_api`, `batch_call_apis`, `poll_job`, `verify_bank_account`, `confirm_bank_account`, `get_bank_account_verification`, `get_account_holder_name` |\n| `billing.read` | `get_usage`, `get_forecast` |\n\n> **Local stdio schema differences:** the tool reference below documents the Remote MCP.\n> On the local stdio server a few parameter names differ — `call_api` takes `api_id` +\n> `params` (Remote: `slug` + `body`/`query`), `compare_apis` takes `api_ids` (Remote:\n> `slugs`), `estimate_cost` takes `api_id`. The local server additionally exposes\n> `set_byok_key`, `migrate_project`, and account-onboarding tools; the Korean bank-account\n> verification tools are Remote-only.\n\n---\n\n## Tools (14)\n\n### `search_apis`\nSearch the apitree marketplace by natural language intent.\n\n**Parameters:**\n- `intent` (string, required) — what API you need, e.g. `\"weather data\"`, `\"Korean stock prices\"`, `\"IP geolocation\"`\n- `category` (string, optional) — filter: `financial`, `data`, `ai`, `communication`, `commerce`, `public`\n- `max_results` (number, optional, default: 5) — max results (1–20)\n\n**Returns:** List of matching APIs with slug, name, description, pricing, SLA, auth type, and proxy URL.\n\n**Example:** `search_apis(\"find weather APIs that don't need a key\")`\n\n---\n\n### `call_api`\nCall any API through the apitree proxy gateway. Handles auth injection, caching, rate limiting, and usage tracking automatically.\n\n**Parameters:**\n- `slug` (string, required) — API slug from `search_apis`, e.g. `\"open-meteo-forecast\"`\n- `path` (string, optional) — sub-path, e.g. `\"/forecast?latitude=37.5&longitude=127.0\"`\n- `method` (enum, optional, default: `\"GET\"`) — `GET`, `POST`, `PUT`, `PATCH`, `DELETE`\n- `body` (object, optional) — request body for POST/PUT/PATCH\n- `query` (object, optional) — query parameters as key-value map\n\n**Returns:** Direct API response body.\n\n**Auth required:** Yes.\n\n**Example:** `call_api(\"open-meteo-forecast\", \"/forecast?latitude=37.5665&longitude=126.9780&current_weather=true\")`\n\n---\n\n### `get_api_details`\nGet full documentation for a specific API: all endpoints, parameters, required headers, pricing per call, SLA uptime %, p95 latency, auth type, and cache TTL.\n\n**Parameters:**\n- `slug` (string, required) — API slug\n\n**Returns:** Full API record including endpoint list and pricing breakdown.\n\n**Example:** `get_api_details(\"coingecko-public\")`\n\n---\n\n### `batch_call_apis`\nCall up to 10 APIs concurrently in a single request. Deduplicates identical sub-requests. Returns results in the same order as the input array.\n\n**Parameters:**\n- `calls` (array, required, 1–10 items) — list of `{ slug, path?, method?, body? }` objects\n\n**Returns:** Array of `{ slug, status, data?, error? }` in input order.\n\n**Auth required:** Yes.\n\n**Example:** `batch_call_apis([{ slug: \"open-meteo-forecast\", path: \"/forecast?latitude=37.5&longitude=127.0\" }, { slug: \"coingecko-public\", path: \"/coins/bitcoin\" }])`\n\n---\n\n### `get_usage`\nGet your apitree account usage statistics: credit balance, API calls today / last 7d / last 30d, top APIs used, and plan info.\n\n**Parameters:** None.\n\n**Returns:** `{ balance: { credits, usd }, usage: { today, 7d, 30d, top_apis } }`\n\n**Auth required:** Yes.\n\n---\n\n### `estimate_cost`\nPreview the credit cost for a given API before making the actual call.\n\n**Parameters:**\n- `slug` (string, required) — API slug\n- `calls` (number, optional, default: 1) — number of calls to estimate\n\n**Returns:** `{ slug, credits_per_call, usd_per_call, credits_for_N, usd_for_N }`\n\n**Example:** `estimate_cost(\"openai-chat\", 100)`\n\n---\n\n### `compare_apis`\nCompare 2–5 APIs side-by-side on pricing, SLA uptime, p95 latency, auth type, cache TTL, and region coverage.\n\n**Parameters:**\n- `slugs` (array of string, required, 2–5 items) — API slugs to compare\n\n**Returns:** Comparison table with winner-per-dimension highlights.\n\n**Example:** `compare_apis([\"openweather\", \"open-meteo-forecast\", \"weatherapi\"])`\n\n---\n\n### `list_capabilities`\nGet a capability map of the entire catalog: top tags (e.g. `weather`, `finance`, `korea`, `free`) with exemplar APIs per tag. Good for discovery when the user doesn't know what API exists.\n\n**Parameters:**\n- `tag_limit` (number, optional, default: 20) — number of top tags to return (1–50)\n- `per_tag` (number, optional, default: 3) — exemplar APIs per tag (1–5)\n\n**Returns:** `{ capabilities: [{ tag, count, examples: [{ slug, name, description }] }] }`\n\n---\n\n### `top_healthy_apis`\nReturn APIs ranked by composite health score: uptime (40%) + error resistance (40%) + latency grade (20%). Ideal when reliability is the primary concern.\n\n**Parameters:**\n- `category` (string, optional) — filter by category\n- `tag` (string, optional) — filter by tag, e.g. `\"free\"`, `\"weather\"`, `\"korea\"`\n- `limit` (number, optional, default: 10) — max results (1–50)\n\n**Returns:** Ranked list with health score (0–100) and grade (A–F) per API.\n\n**Example:** `top_healthy_apis(tag=\"free\", limit=20)` → best free APIs by reliability\n\n---\n\n### `trending_by_tag`\nFind trending APIs by tag over the last 30 days, sorted by call growth rate.\n\n**Parameters:**\n- `tag` (string, required) — e.g. `\"finance\"`, `\"weather\"`, `\"korea\"`, `\"free\"`, `\"ai\"`\n- `limit` (number, optional, default: 10)\n\n**Returns:** APIs with growth % and total call volume.\n\n---\n\n### `recommend_apis`\nGet API recommendations for a high-level goal, with reasoning and a suggested next step.\n\n**Parameters:**\n- `goal` (string, required) — e.g. `\"build a personal finance dashboard for Korean users\"`\n- `budget_credits` (number, optional) — max credits per call\n\n**Returns:** `{ goal, recommendations: [...], tip }` — tip always includes a `call_api` next step.\n\n---\n\n### `get_system_health`\nCheck apitree platform health: overall status, degraded components, circuit breaker state, and incident summary.\n\n**Parameters:** None.\n\n**Returns:** `{ status: { overall, components, latency_p95_ms }, incidents: [...] }`\n\n---\n\n### `get_active_incidents`\nList currently open incidents (outages, degradations, maintenance windows). Returns an empty array when everything is operational.\n\n**Parameters:** None.\n\n**Returns:** `{ incidents: [{ id, title, severity, status, affected_apis, created_at }] }`\n\n---\n\n### `get_forecast`\nForecast how long your credit balance will last based on recent usage. Returns depletion date, daily burn rate, and cache savings ratio.\n\n**Parameters:** None.\n\n**Auth required:** Yes.\n\n**Returns:** `{ balance_credits, daily_burn_rate, days_remaining, depletion_date, cache_savings_ratio }`\n\n---\n\n## Resources (4)\n\nAvailable in the **local stdio** server via `apitree://` URI:\n\n| Resource URI | Content |\n|---|---|\n| `apitree://stats` | Total APIs, calls today, categories, providers |\n| `apitree://categories` | All categories with API counts |\n| `apitree://featured` | Top 10 APIs by popularity |\n| `apitree://health` | Platform health summary |\n\n---\n\n## Prompts (2)\n\nBuilt-in conversation starters available in the **local stdio** server:\n\n| Prompt | When to use |\n|---|---|\n| `discover-apis` | Start here — guided workflow for finding and calling APIs |\n| `optimize-costs` | Reduce credit spend via caching, batching, and cheaper alternatives |\n\n---\n\n## Usage Examples\n\n```\n\"날씨 API 찾아서 서울 기온 알려줘\"\n→ search_apis(\"weather data Korea\") → call_api(\"open-meteo-forecast\", \"...\")\n\n\"Find a payment API for the Korean market\"\n→ search_apis(\"Korean payment gateway\", category=\"financial\")\n\n\"비트코인 시세 조회해줘\"\n→ call_api(\"coingecko-public\", \"/coins/bitcoin?localization=false\")\n\n\"Compare OpenWeather vs Open-Meteo — which is cheaper and more reliable?\"\n→ compare_apis([\"openweather\", \"open-meteo-forecast\"])\n\n\"I have 500 credits — how long will that last?\"\n→ get_forecast()\n\n\"Get Seoul weather and Bitcoin price at the same time\"\n→ batch_call_apis([{ slug: \"open-meteo-forecast\", ... }, { slug: \"coingecko-public\", ... }])\n\n\"What APIs are trending in finance?\"\n→ trending_by_tag(\"finance\", limit=10)\n\n\"Show me the most reliable free APIs\"\n→ top_healthy_apis(tag=\"free\", limit=20)\n\n\"What can I do with apitree?\"\n→ list_capabilities(tag_limit=30)\n```\n\n---\n\n## API Catalog\n\n| Category | Examples | Count |\n|---|---|---|\n| **Data / Utility** | Weather, NASA, SpaceX, Wikipedia, GitHub, World Bank | 700+ |\n| **AI / LLM** | OpenAI, Anthropic, Gemini, Groq, Mistral, CLOVA, Upstage | 90+ |\n| **Financial** | Exchange Rates, CoinGecko, Alpha Vantage, OPEN DART | 120+ |\n| **Korean Government** | 공공데이터포털 (45K+ datasets via API gateway) | 400+ |\n| **Korean Payments** | PortOne, 토스페이먼츠, 부트페이, 페이플 | 4 |\n| **Korean SaaS** | 채널톡, 모두싸인, 팝빌, WEHAGO, 알리고 SMS | 25+ |\n| **Messaging** | Twilio, SendGrid, Discord, Slack, SOLAPI | 60+ |\n| **Maps / Transit** | Kakao Mobility, T맵, ODsay, Nominatim | 30+ |\n| **Identity / KYC** | NICE 본인인증, KCB, Stripe Identity | 7+ |\n| **Commerce** | Shopify, Stripe, Fake Store, DummyJSON | 20+ |\n| **Voice / Audio** | ElevenLabs, Deepgram, Cartesia, OpenAI Whisper | 10+ |\n| **Image / Video** | DALL-E, Flux, Stable Diffusion, Runway, Luma | 20+ |\n| **Search** | Brave, Tavily, Exa, Serper, Perplexity | 5+ |\n\n### Free APIs (no key needed)\n\nWorks with just your apitree token — the proxy handles routing:\n\n`open-meteo-forecast` · `rest-countries` · `coingecko-public` · `hacker-news` ·\n`wikipedia-summary` · `rick-and-morty` · `pokeapi` · `exchange-rates` ·\n`usgs-earthquake` · `spacex-launches` · `world-bank-data` · `us-fed-fred` ·\n`openfda-drugs` · `google-books` · `cat-facts` · `joke-api` · `advice-slip` ·\n`chucknorris-io` · `coinpaprika` · `open-notify-iss` · `randomuser-me` ·\n`dog-ceo-api` · `numbersapi` · `agify` · `nationalize` · `genderize` ·\n`disease-sh` · `open-library-books` · `dummyjson-products` · and 510+ more\n\n---\n\n## Stack with other MCP servers\n\napitree is additive — agents can connect multiple MCP servers simultaneously:\n\n| MCP Server | Domain | apitree adds |\n|---|---|---|\n| **Shopify MCP** | E-commerce | AI APIs, payment providers, logistics data |\n| **GitHub MCP** | Code | External APIs for testing, monitoring, enrichment |\n| **Figma MCP** | Design | AI image generation, real data for mockups |\n| **Slack MCP** | Messaging | Notification APIs, analytics, external triggers |\n| **Notion MCP** | Docs | Financial data, public datasets, AI content APIs |\n\n---\n\n## Environment Variables (local stdio)\n\n| Variable | Default | Description |\n|---|---|---|\n| `APITREE_API_KEY` | — | Your apitree API key (`nxs_live_...`) |\n| `APITREE_API_URL` | `https://apitree.ai` | API base URL (override for local dev) |\n| `APITREE_AGENT_ID` | auto-detected | Agent identifier for telemetry |\n| `APITREE_MODEL_ID` | auto-detected | LLM model identifier for fine-tuning labels |\n\n---\n\n## Links\n\n| Resource | URL |\n|---|---|\n| Website | https://apitree.ai |\n| Sign up (free) | https://apitree.ai/signup |\n| Remote MCP endpoint | https://apitree.ai/api/mcp |\n| API docs | https://apitree.ai/docs |\n| OpenAPI spec | https://apitree.ai/api/openapi.json |\n| TypeScript SDK | `npm install @apitreedev/sdk` |\n| Status page | https://apitree.ai/status |\n| Catalog | https://apitree.ai/catalog |\n\n---\n\n## License\n\nMIT\n","readmeFilename":"README.md"}