allthingsdev-mcp-server/README.md

🚀 Official MCP server for AllThingsDev API marketplace. Discover, search, and integrate 600+ APIs directly through Claude Desktop, Cursor IDE, and other AI assistants. Features real-time API search, pricing comparison, endpoint documentation, and seamles

# AllThingsDev MCP Server 🚀

[![npm version](https://badge.fury.io/js/allthingsdev-mcp-server.svg)](https://badge.fury.io/js/allthingsdev-mcp-server)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Node.js Version](https://img.shields.io/badge/node-%3E%3D18-brightgreen.svg)](https://nodejs.org/)

> **Official MCP server for AllThingsDev API marketplace** - Discover, search, and integrate **600+ APIs** directly through Claude Desktop and other AI assistants.

## 🌟 What is AllThingsDev?

[AllThingsDev](https://www.allthingsdev.co) is the ultimate API marketplace where developers can discover, integrate, and monetize APIs. From location services and data scraping to AI tools and financial APIs - we've got everything you need to supercharge your projects.

## ✨ Features

🔍 **Smart API Discovery** - Search through 600+ APIs using natural language
📊 **Pricing Comparison** - Compare plans across different APIs instantly  
📖 **Comprehensive Documentation** - Get endpoint details, examples, and integration guides
🏷️ **Category Browsing** - Explore APIs by functionality and use cases
💬 **Built-in FAQ** - Get answers about the AllThingsDev platform
⚡ **Real-time Data** - Always up-to-date API information

## 🚀 Quick Start

### Install & Setup (2 minutes)

```bash
# Install globally
npm install -g allthingsdev-mcp-server

# Or use directly without installation
npx allthingsdev-mcp-server
```

### Add to Claude Desktop

1. Open Claude Desktop config file:
   - **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
   - **Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`
   - **Linux**: `~/.config/Claude/claude_desktop_config.json`

2. Add the server configuration:

```json
{
  "mcpServers": {
    "allthingsdev": {
      "command": "npx",
      "args": ["allthingsdev-mcp-server"]
    }
  }
}
```

3. Restart Claude Desktop - that's it! 🎉

### Add to Cursor IDE

**🚀 One-Click Install**: 
```bash
# Generate install link
node cursor-install.js
```

Or manually add to your Cursor MCP configuration:

```json
{
  "allthingsdev": {
    "command": "npx",
    "args": ["-y", "allthingsdev-mcp-server"]
  }
}
```

### Add to Windsurf IDE

**🌊 Easy Setup**:
```bash
# Get installation instructions
node windsurf-install.js
```

Or manually add to your Windsurf config file:
- **macOS**: `~/Library/Application Support/Windsurf/config.json`
- **Windows**: `%APPDATA%\Windsurf\config.json`  
- **Linux**: `~/.config/Windsurf/config.json`

```json
{
  "mcpServers": {
    "allthingsdev": {
      "command": "npx",
      "args": ["-y", "allthingsdev-mcp-server"]
    }
  }
}
```

## 💬 Example Conversations

Once installed, you can ask your AI assistant (Claude, Cursor, Windsurf) questions like:

```
🤖 "Find APIs for currency conversion"
🤖 "Show me all location-based APIs under $10/month"
🤖 "What are the endpoints for the Weather API?"
🤖 "How do I publish my API on AllThingsDev?"
🤖 "Compare pricing for data scraping APIs"
```

## 🛠️ Available Tools

### 🔍 `search_apis`
Search for APIs by keywords, functionality, or categories
```javascript
// Example: Find payment processing APIs
search_apis({ query: "payment processing", limit: 5 })
```

### 📋 `get_api_details`
Get comprehensive information about any API
```javascript
// Example: Get details about specific API
get_api_details({ apiId: "currency-exchange-api" })
```

### 📂 `list_api_categories`
Browse APIs organized by categories
```javascript
// Example: See all available categories
list_api_categories({ showCount: true })
```

### 💰 `get_pricing_info`
Compare pricing across APIs
```javascript
// Example: Find APIs under $25/month
get_pricing_info({ maxPrice: 25 })
```

### ❓ `search_faq`
Get answers to platform questions
```javascript
// Example: Learn about publishing APIs
search_faq({ query: "how to publish API" })
```

### 🔗 `get_api_endpoints`
Get detailed endpoint information
```javascript
// Example: See all endpoints for an API
get_api_endpoints({ apiId: "location-finder" })
```

## 🎯 Use Cases

### For Developers
- **API Discovery**: Find the perfect APIs for your next project
- **Integration Help**: Get code examples and documentation instantly
- **Cost Planning**: Compare pricing to fit your budget
- **Technical Support**: Access FAQ and community discussions

### For API Publishers
- **Marketplace Insights**: Understand what APIs are popular
- **Competitive Analysis**: See pricing and features of similar APIs
- **Publishing Guidance**: Get help with listing your API

### For Project Managers
- **Vendor Evaluation**: Compare multiple API providers quickly
- **Cost Estimation**: Calculate API costs for project budgeting
- **Technical Requirements**: Understand API capabilities and limitations

## 🏗️ Architecture

This MCP server provides a bridge between AI assistants and the AllThingsDev marketplace:

```
Claude Desktop ↔ MCP Server ↔ AllThingsDev Data
     ↑                ↑              ↑
  Your queries    Smart search    600+ APIs
```

- **Local Processing**: All searches happen locally for fast responses
- **Real-time Data**: Server includes the latest API information
- **Privacy First**: No data sent to external servers during search

## 🔧 Advanced Usage

### Custom MCP Clients

The server works with any MCP-compatible client:

```bash
# Run the server
allthingsdev-mcp-server

# Or via npx
npx allthingsdev-mcp-server
```

### Development Mode

```bash
# Clone the repository
git clone https://github.com/allthingsdev/mcp-server
cd mcp-server

# Install dependencies
npm install

# Run in development mode
npm run dev
```

## 📊 API Categories Available

Our marketplace includes APIs for:

- 🌍 **Location & Maps** - Geocoding, mapping, location intelligence
- 💱 **Finance & Payments** - Currency exchange, payment processing, crypto
- 🤖 **AI & Machine Learning** - Text analysis, image recognition, chatbots  
- 📊 **Data & Analytics** - Web scraping, data validation, analytics
- 🔐 **Security & Authentication** - OAuth, identity verification, fraud detection
- 📱 **Communication** - SMS, email, push notifications, social media
- 🛒 **E-commerce** - Product catalogs, inventory, shipping, reviews
- 📰 **Content & Media** - News APIs, image processing, content management
- 🎮 **Entertainment** - Games, trivia, jokes, random facts
- 🏥 **Health & Fitness** - Medical data, fitness tracking, nutrition

## 🤝 Contributing

We welcome contributions! Here's how to help:

1. **Report Issues**: Found a bug? [Open an issue](https://github.com/allthingsdev/mcp-server/issues)
2. **Feature Requests**: Have an idea? We'd love to hear it!
3. **Documentation**: Help improve our guides and examples
4. **Code**: Submit PRs for bug fixes and enhancements

## 📚 Resources

- 🌐 **AllThingsDev Website**: https://www.allthingsdev.co
- 📖 **API Documentation**: https://www.allthingsdev.co/docs
- 💬 **Community Forum**: https://www.allthingsdev.co/community
- 📧 **Support**: support@allthingsdev.co
- 🐙 **GitHub**: https://github.com/allthingsdev/mcp-server

## 🏷️ Tags

`mcp-server` `api-marketplace` `claude-desktop` `ai-assistant` `developer-tools` `api-discovery` `model-context-protocol` `allthingsdev` `api-integration` `developer-productivity`

## 📄 License

MIT License - see [LICENSE](LICENSE) file for details.

---

**Built with ❤️ by the AllThingsDev team**

*Empowering developers to build better applications with the world's largest API marketplace*