# FeedMob MCP Server

MCP (Model Context Protocol) server for the FeedMob Assistant Internal API. Enables AI assistants like Claude to access FeedMob data.

[![npm version](https://badge.fury.io/js/feedmob-mcp-server.svg)](https://www.npmjs.com/package/feedmob-mcp-server)

## Quick Start

### Using npx (Recommended)

```bash
# Set your API token
export FEEDMOB_API_TOKEN="your-api-token-here"

# Run directly with npx
npx feedmob-mcp-server
```

### Global Installation

```bash
npm install -g feedmob-mcp-server

# Then run
feedmob-mcp-server
```

### Local Development

```bash
git clone https://github.com/hlee/femini-tokyo-mcp.git
cd femini-tokyo-mcp
npm install
npm run build
node dist/index.js
```

## Environment Variables

```bash
export FEEDMOB_API_TOKEN="your-api-token-here"
export FEEDMOB_API_BASE_URL="https://assistant.feedmob.ai"  # Optional, this is the default
```

## Claude for Desktop Configuration

Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "feedmob": {
      "command": "npx",
      "args": ["feedmob-mcp-server"],
      "env": {
        "FEEDMOB_API_TOKEN": "your-token"
      }
    }
  }
}
```

## Available Tools

| Tool | Description |
|------|-------------|
| `list_clients` | List clients with filters |
| `get_client` | Get client details by ID |
| `list_client_documents` | List client documents |
| `list_partners` | List partners with filters |
| `get_partner` | Get partner details by ID |
| `list_partner_categories` | List partner categories |
| `list_partner_documents` | List partner documents |
| `list_campaigns` | List campaigns with filters |
| `get_campaign` | Get campaign details by ID |
| `list_playbooks` | List playbooks |
| `get_playbook` | Get playbook with items |
| `get_playbook_item` | Get playbook item content |
| `list_mobile_apps` | List mobile apps |
| `get_mobile_app` | Get mobile app details |
| `list_click_urls` | List click URLs |
| `get_click_url` | Get click URL by legacy ID |
| `get_daily_metrics` | Get daily metrics time-series |
| `list_pods` | List organizational pods |

## License

MIT