# Mobilize US MCP Server

This project exposes a read-only MCP server for Mobilize public API data, including organizations, events, and enums.

## What It Supports

- List organizations (useful as groups)
- List promoted organizations for an organization
- Get a public event by id
- List organization events with filtering
- Get an organization event
- List deleted organization events
- Get enum metadata

## API Source

The implementation follows the public Mobilize API docs:
[mobilizeamerica/api](https://github.com/mobilizeamerica/api)

Base URL: [https://api.mobilize.us/v1](https://api.mobilize.us/v1)

## Setup

1. Install dependencies:

  ```bash
   uv pip install -r requirements.txt
  ```

1. Add environment variables to .env if needed:

  ```env
   MOBILIZE_API_KEY=your_optional_api_key
  MOBILIZE_API_BASE_URL=https://api.mobilize.us/v1
   MOBILIZE_HTTP_TIMEOUT=20
  ```

Notes:

- Most tools are public and work without an API key.
- If you have privileged access, set MOBILIZE_API_KEY to include authenticated fields where supported.

## Run Locally

Use uv with MCP CLI compatibility for FastMCP:

```bash
uv run --with "mcp[cli]<2" --with python-dotenv --with requests mcp run server.py
```

## Claude Desktop Config Snippet

```json
{
  "mcpServers": {
    "MobilizeUSMCP": {
      "cwd": "C:/Users/CarlF/workspace/GCDP/communication-management/mobilize-us-mcp-server",
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]<2",
        "--with",
        "python-dotenv",
        "--with",
        "requests",
        "mcp",
        "run",
        "C:/Users/CarlF/workspace/GCDP/communication-management/mobilize-us-mcp-server/server.py"
      ]
    }
  }
}
```