# @chaosintelligence/mcp

MCP server for [Chaos Intelligence](https://chaosintelligence.com) — access your Capture thoughts and Resonate posts from Claude, Cursor, and other AI tools.

## Quick Start

### Claude Code (Plugin)

Browse plugins → **Add marketplace from GitHub** → `Chaos-Intelligence-Inc/chaos-mcp-server`

You'll be prompted to set your `CHAOS_API_KEY`.

### Claude Code (Manual)

Add to your project's `.mcp.json`:

```json
{
  "mcpServers": {
    "chaos": {
      "command": "npx",
      "args": ["-y", "@chaosintelligence/mcp"],
      "env": {
        "CHAOS_API_KEY": "chaos_your_key_here"
      }
    }
  }
}
```

### Claude Desktop

Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):

```json
{
  "mcpServers": {
    "chaos": {
      "command": "npx",
      "args": ["-y", "@chaosintelligence/mcp"],
      "env": {
        "CHAOS_API_KEY": "chaos_your_key_here"
      }
    }
  }
}
```

## Getting an API Key

1. Sign up at [chaosintelligence.com](https://chaosintelligence.com)
2. Subscribe to Level 1
3. Go to **Settings → API Keys** and generate a key
4. Your key will look like `chaos_` followed by 32 characters

## Available Tools

### Capture (Thoughts)

| Tool | Description |
|------|-------------|
| `list_thoughts` | List thoughts with filters (stream, category, date, search) |
| `get_thought` | Get a thought by ID with all content blocks |
| `search_similar` | Semantic search for similar thoughts |
| `search_thoughts` | Semantic search with structured filters |
| `list_streams` | List streams (folders for organizing thoughts) |
| `get_stream` | Get a stream with its thoughts |
| `search_streams` | Search streams by name/description |
| `get_stats` | Summary statistics for your thoughts |
| `list_recent_thoughts` | Quick access to recent thoughts |
| `create_thought` | Capture a new thought (text, images, links) |

### Pages

| Tool | Description |
|------|-------------|
| `list_pages` | List generated pages with filters |
| `get_page` | Get a page with full content |
| `update_page` | Edit a page's title, content, or description |
| `search_pages` | Search pages by title or content |

### Resonate (Posts)

| Tool | Description |
|------|-------------|
| `search_posts` | Semantic search for public posts |
| `list_posts` | Browse posts with filters and sorting |
| `get_post` | Get post details with votes and reactions |
| `get_post_demographics` | Demographic voting breakdown |
| `get_topic_clusters` | Trending topics with heat scores |
| `get_my_votes` | Your voting history |
| `get_my_post_performance` | Performance data for your posts |

### Utility

| Tool | Description |
|------|-------------|
| `get_usage` | API usage stats and rate limits |
| `get_reactions` | Available reaction types |
| `get_classifications` | Thought classification types |
| `get_categories` | Available categories |

## Development

```bash
git clone https://github.com/Chaos-Intelligence-Inc/chaos-mcp-server.git
cd chaos-mcp-server
npm install --ignore-scripts
npm run build
```

Test with the MCP Inspector:

```bash
CHAOS_API_KEY=chaos_yourkey npx @modelcontextprotocol/inspector node dist/index.js
```

## License

MIT