# Gloria AI MCP Server

MCP server providing real-time curated crypto news from [Gloria AI](https://itsgloria.ai) to AI agents.

## Tools

### Free tier
| Tool | Description |
|------|-------------|
| `get_latest_news` | Latest curated crypto headlines with sentiment and categories |
| `get_news_recap` | AI-generated summary for a category (hourly for crypto/macro) |
| `search_news` | Search news by keyword |
| `get_categories` | List all 18+ news categories |
| `get_news_item` | Get a specific news item by ID |

### Paid tier (x402)
| Tool | Description |
|------|-------------|
| `get_enriched_news` | Full context, entity analysis, token mentions |
| `get_ticker_summary` | 24h AI summary for any ticker/topic |

Paid tools return payment instructions using the [x402 protocol](https://x402.org) (USDC on Base).

## Quick start

### Claude Desktop / Claude Code (stdio)

```json
{
  "mcpServers": {
    "gloria": {
      "command": "uv",
      "args": ["--directory", "/path/to/gloria-mcp", "run", "gloria-mcp"],
      "env": {
        "GLORIA_API_TOKEN": "your_token",
        "AI_HUB_BASE_URL": "https://ai-hub.cryptobriefing.com"
      }
    }
  }
}
```

### Remote (Streamable HTTP)

```bash
export GLORIA_API_TOKEN=your_token
export AI_HUB_BASE_URL=https://ai-hub.cryptobriefing.com
export MCP_TRANSPORT=streamable-http
export MCP_PORT=8005

uv run gloria-mcp
```

## Development

```bash
# Install
uv pip install -e .

# Test with MCP Inspector
mcp dev src/gloria_mcp/server.py

# Run directly
uv run gloria-mcp
```

## Environment variables

| Variable | Required | Default |
|----------|----------|---------|
| `GLORIA_API_TOKEN` | Yes | — |
| `AI_HUB_BASE_URL` | No | `https://ai-hub.cryptobriefing.com` |