{
  "markdown": "# APIVerve MCP Server\r\n\r\n<div align=\"center\">\r\n\r\n<img src=\"https://apiverve.com/images/favicon.png\" alt=\"APIVerve Logo\" width=\"80\" />\r\n\r\n**368+ APIs accessible through the Model Context Protocol**\r\n\r\n[![npm version](https://img.shields.io/npm/v/@apiverve/mcp-server)](https://www.npmjs.com/package/@apiverve/mcp-server)\r\n[![PyPI version](https://img.shields.io/pypi/v/apiverve-mcp)](https://pypi.org/project/apiverve-mcp/)\r\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\r\n[![MCP Compatible](https://img.shields.io/badge/MCP-Compatible-blue)](https://modelcontextprotocol.io)\r\n\r\n[Website](https://apiverve.com) • [Documentation](https://docs.apiverve.com) • [API Explorer](https://apiverve.com/marketplace) • [Report Bug](https://github.com/apiverve/mcp-server/issues)\r\n\r\n</div>\r\n\r\n## 🚀 Overview\r\n\r\nThe **APIVerve MCP Server** provides seamless access to 368+ production-ready APIs through the [Model Context Protocol](https://modelcontextprotocol.io). Connect AI assistants like Claude, ChatGPT, and other MCP-compatible clients to a vast ecosystem of data and functionality.\r\n\r\n### ✨ Features\r\n\r\n- 🎯 **368+ APIs** - Weather, news, geocoding, validation, conversion, and more\r\n- 🔐 **OAuth 2.0 Authentication** - Secure, industry-standard authentication\r\n- 📊 **Token-Based Pricing** - Pay only for what you use\r\n- 🚀 **High Performance** - Cloud-hosted with 99%+ uptime\r\n- 📖 **Rich Documentation** - Complete API documentation with examples\r\n- 🔄 **Auto-Updated** - Always access the latest API features\r\n\r\n## 📦 Installation\r\n\r\nAPIVerve is a **remote** MCP server — there is nothing to run locally. Point your client at the URL below and it will handle sign-in for you.\r\n\r\n### Quick setup\r\n\r\n```bash\r\nnpx @apiverve/mcp-server\r\n```\r\n\r\nConfigures VS Code and Cursor, and prints the manual step for Claude Desktop. Target one client with `npx @apiverve/mcp-server cursor`.\r\n\r\nFor headless setups, pass a key instead of using sign-in:\r\n\r\n```bash\r\nnpx @apiverve/mcp-server --api-key YOUR_API_KEY\r\n```\r\n\r\nPython users can do the same with `pip install apiverve-mcp` then `apiverve-mcp` (or `apiverve-mcp --api-key YOUR_API_KEY`).\r\n\r\n### Manual setup\r\n\r\n**Claude Desktop** — remote servers are added through the app, not a config file:\r\n\r\n> Settings → Connectors → Add custom connector → `https://api.apiverve.com/v1/mcp`\r\n\r\n**VS Code** (`mcp.json`):\r\n```json\r\n{\r\n  \"servers\": {\r\n    \"apiverve\": {\r\n      \"type\": \"http\",\r\n      \"url\": \"https://api.apiverve.com/v1/mcp\"\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n**Cursor** (`~/.cursor/mcp.json`):\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"apiverve\": {\r\n      \"url\": \"https://api.apiverve.com/v1/mcp\"\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n## 🔑 Authentication\r\n\r\nTwo ways in — pick whichever fits:\r\n\r\n**OAuth (default, recommended)** — leave the config as shown above. On first use the server returns an authorization challenge and your client walks you through sign-in. No key is stored on disk, and access can be revoked from the dashboard.\r\n\r\n**API key** — add your key as a header. Useful for CI and headless environments where no browser is available:\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"apiverve\": {\r\n      \"url\": \"https://api.apiverve.com/v1/mcp\",\r\n      \"headers\": { \"x-api-key\": \"YOUR_API_KEY\" }\r\n    }\r\n  }\r\n}\r\n```\r\n\r\nClaude Desktop's Custom Connectors cannot send custom headers, so it is OAuth-only.\r\n\r\nGet a key at [https://apiverve.com](https://apiverve.com). **Free tier available** — no credit card required to start!\r\n\r\n## 🎯 Available APIs\r\n\r\n<details>\r\n<summary><b>Click to see all 368+ available APIs</b></summary>\r\n\r\n### 🌤️ Weather & Environment\r\n- Weather Forecast\r\n- Air Quality\r\n- Marine Weather\r\n- UV Index\r\n- Weather Seasons\r\n- And more...\r\n\r\n### 🌍 Location & Geocoding\r\n- Reverse Geocoding\r\n- IP Lookup\r\n- Timezone Lookup\r\n- Airports Lookup\r\n- Distance Calculator\r\n- And more...\r\n\r\n### ✅ Validation & Verification\r\n- Email Validator\r\n- Phone Number Validator\r\n- Domain Availability\r\n- SSL Certificate Checker\r\n- And more...\r\n\r\n### 🔄 Conversion & Calculation\r\n- Currency Converter\r\n- Unit Converter\r\n- Date Calculator\r\n- BMI Calculator\r\n- And more...\r\n\r\n### 📰 News & Content\r\n- World News\r\n- RSS to JSON\r\n- Web Scraper\r\n- Metadata Extractor\r\n- And more...\r\n\r\n### 🎲 Random Data Generators\r\n- Random User Generator\r\n- Password Generator\r\n- Lorem Ipsum Generator\r\n- And more...\r\n\r\n**[See complete API list →](https://apiverve.com/marketplace)**\r\n\r\n</details>\r\n\r\n## 💡 Usage Examples\r\n\r\nOnce configured, use APIs naturally in conversation:\r\n\r\n### With Claude Desktop\r\n\r\n```\r\nUser: What's the weather in San Francisco?\r\nClaude: [Uses Weather API]\r\n\r\nUser: Validate this email: test@example.com\r\nClaude: [Uses Email Validator API]\r\n\r\nUser: Convert 100 USD to EUR\r\nClaude: [Uses Currency Converter API]\r\n```\r\n\r\n### Programmatic Usage (Python)\r\n\r\nConnect straight to the remote server — no local process involved:\r\n\r\n```python\r\nfrom mcp import ClientSession\r\nfrom mcp.client.streamable_http import streamablehttp_client\r\n\r\nurl = \"https://api.apiverve.com/v1/mcp\"\r\nheaders = {\"x-api-key\": \"YOUR_API_KEY\"}\r\n\r\nasync with streamablehttp_client(url, headers=headers) as (read, write, _):\r\n    async with ClientSession(read, write) as session:\r\n        await session.initialize()\r\n\r\n        # List available tools\r\n        tools = await session.list_tools()\r\n\r\n        # Call a tool\r\n        result = await session.call_tool(\"emailvalidator\", {\r\n            \"email\": \"test@example.com\"\r\n        })\r\n```\r\n\r\n## 📊 Pricing\r\n\r\nAPIVerve uses a flexible token-based pricing model with multiple tiers to fit your needs:\r\n\r\n- **Free Tier Available** - Start building immediately, no credit card required\r\n- **Pay-as-you-go** - Scale up as your usage grows\r\n- **Enterprise Plans** - Custom solutions for high-volume users\r\n\r\n**[View Pricing Plans →](https://apiverve.com/pricing)**\r\n\r\nCredit costs vary by API complexity - simple APIs start at 1 credit per call.\r\n\r\n## 🛠️ Technical Details\r\n\r\n### Server Information\r\n\r\n- **Transport**: Streamable HTTP\r\n- **Protocol**: MCP 2025-06-18 (negotiates down to 2025-03-26 and 2024-11-05)\r\n- **Authentication**: OAuth 2.0 with PKCE, or `x-api-key` header\r\n- **Base URL**: `https://api.apiverve.com/v1/mcp`\r\n- **API Version**: 1.1.0\r\n\r\n### OAuth Endpoints\r\n\r\n- **Discovery**: `https://api.apiverve.com/.well-known/openid-configuration`\r\n- **Authorization**: `https://api.apiverve.com/authorize`\r\n- **Token**: `https://api.apiverve.com/token`\r\n- **Registration**: `https://api.apiverve.com/register` (Dynamic client registration)\r\n\r\n### Tool Schema\r\n\r\nEach API is exposed as an MCP tool with:\r\n- **name**: API identifier (e.g., `emailvalidator`)\r\n- **description**: Human-readable description with token cost\r\n- **inputSchema**: JSON Schema defining required/optional parameters\r\n\r\n## 🔧 Troubleshooting\r\n\r\n### Connection Issues\r\n\r\nIf you see authentication errors:\r\n\r\n1. Check your API key at [https://apiverve.com/dashboard](https://apiverve.com/dashboard)\r\n2. Ensure OAuth redirect URI is correct\r\n3. Try re-authorizing the connection\r\n\r\n### Token Limits\r\n\r\nIf you hit token limits:\r\n- Check usage at [https://apiverve.com/dashboard](https://apiverve.com/dashboard)\r\n- Upgrade your plan\r\n- Contact support for enterprise options\r\n\r\n## 📚 Documentation\r\n\r\n- **API Documentation**: [https://docs.apiverve.com](https://docs.apiverve.com)\r\n- **MCP Specification**: [modelcontextprotocol.io](https://modelcontextprotocol.io)\r\n- **Getting Started Guide**: [https://apiverve.com/docs/getting-started](https://apiverve.com/docs/getting-started)\r\n\r\n## 🤝 Support\r\n\r\n- **GitHub Issues**: [apiverve/mcp-server/issues](https://github.com/apiverve/mcp-server/issues)\r\n- **Email**: hello@apiverve.com\r\n- **Discord**: [Join our community](https://apiverve.com/discord)\r\n\r\n## 📄 License\r\n\r\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\r\n\r\n## 🌟 Star Us!\r\n\r\nIf you find this useful, please consider starring the repo on GitHub!\r\n\r\n---\r\n\r\n<div align=\"center\">\r\n\r\n**Built with ❤️ by [APIVerve](https://apiverve.com)**\r\n\r\n[Website](https://apiverve.com) • [Dashboard](https://apiverve.com/dashboard) • [API Explorer](https://apiverve.com/marketplace) • [Documentation](https://docs.apiverve.com)\r\n\r\n</div>\r\n",
  "bytes": 8258,
  "sha": "39c1651b671484203b9946a2c3b25ac6959b3b35dba23899d0abf9b09a1e2ac3",
  "repo_slug": "apiverve/mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_apiverve_mcp_server_f9802dd3/readme"
}