npm package: @meetsponsors/mcp-server
Description: MCP server for Meet Sponsors - Access YouTube sponsorship data directly in Claude Desktop and other LLM tools
Author: Meet Sponsors
Latest version: 1.0.0

# Meet Sponsors MCP Server

Access YouTube sponsorship data directly in Claude Desktop, N8N, and other MCP-compatible tools.

## What is this?

This is an MCP (Model Context Protocol) server that connects to the Meet Sponsors API, giving LLMs direct access to:
- 🏢 Sponsor data (companies, brands, advertisers)
- 🎥 YouTuber data (channels, statistics, demographics)
- 📊 Sponsorship relationships and analytics

## Installation

### Option 1: Use with npx (Recommended)

No installation needed! Just configure and run:

```json
{
  "mcpServers": {
    "meet-sponsors": {
      "command": "npx",
      "args": ["-y", "@meetsponsors/mcp-server"],
      "env": {
        "MCP_API_KEY": "your_api_key_here"
      }
    }
  }
}
```

### Option 2: Install globally

```bash
npm install -g @meetsponsors/mcp-server
```

Then configure:

```json
{
  "mcpServers": {
    "meet-sponsors": {
      "command": "meetsponsors-mcp",
      "env": {
        "MCP_API_KEY": "your_api_key_here"
      }
    }
  }
}
```

## Getting an API Key

1. Go to [meetsponsors.com](https://meetsponsors.com)
2. Sign up or log in
3. Navigate to Settings → API Access
4. Create a new API key with the desired permissions
5. Copy the key (it will only be shown once!)

## Configuration

### Environment Variables

- **MCP_API_KEY** (required): Your Meet Sponsors API key
- **MCP_API_URL** (optional): Custom API URL (defaults to `https://api.meetsponsors.com/mcp`)

### Claude Desktop Setup

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

2. Add the Meet Sponsors server:

```json
{
  "mcpServers": {
    "meet-sponsors": {
      "command": "npx",
      "args": ["-y", "@meetsponsors/mcp-server"],
      "env": {
        "MCP_API_KEY": "mcp_your_key_here"
      }
    }
  }
}
```

3. Restart Claude Desktop

## Usage Examples

Once configured, you can ask Claude:

- "Find me the most active VPN sponsors this month"
- "Which tech YouTubers have over 500k subscribers?"
- "How many videos has Benjamin Code made with Hostinger?"
- "Show me sponsors similar to NordVPN"
- "Find YouTubers who have worked with Squarespace"

## Available Tools

### Sponsors
- `sponsor.search` - Search sponsors with advanced filters
- `sponsor.get` - Get detailed sponsor information
- `sponsor.stats` - Get sponsor statistics
- `sponsor.similar` - Find similar sponsors
- `sponsor.youtubers` - List YouTubers who worked with a sponsor
- `sponsor.mostActive` - Get most active sponsors in a period

### YouTubers
- `youtuber.search` - Search YouTubers with advanced filters
- `youtuber.get` - Get detailed YouTuber information
- `youtuber.sponsors` - List sponsors a YouTuber has worked with
- `youtuber.recentSponsored` - Get recent sponsored videos
- `youtuber.similar` - Find similar YouTubers
- `youtuber.lastActiveBiggest` - Get biggest active YouTubers

## Troubleshooting

### "MCP_API_KEY environment variable is required"

Make sure you've set the `MCP_API_KEY` in your config's `env` section.

### "API request failed: 401"

Your API key is invalid or expired. Generate a new one from the Meet Sponsors dashboard.

### "API request failed: 403"

Your API key doesn't have the required permissions (scopes) for this operation.

### "API request failed: 429"

You've exceeded your monthly quota. Upgrade your plan or wait for the quota to reset.

## Support

- Documentation: https://meetsponsors.com/docs/mcp
- Issues: https://github.com/meetsponsors/mcp-server/issues
- Email: support@meetsponsors.com

## License

MIT