# Nebula MCP server

Use Nebula's read-only market intelligence from MCP-compatible agents and developer tools.

## Connect

Endpoint: `https://nebula-api.hiddensystems.ai/mcp`

Authentication: send your Nebula API key as `X-API-Key` or `Authorization: Bearer`.

### Claude Code

```bash
claude mcp add nebula --transport http https://nebula-api.hiddensystems.ai/mcp --header "X-API-Key: YOUR_API_KEY"
```

### JSON configuration

```json
{
  "mcpServers": {
    "nebula": {
      "url": "https://nebula-api.hiddensystems.ai/mcp",
      "headers": { "X-API-Key": "YOUR_API_KEY" }
    }
  }
}
```

## Tools

- `search_tokens`: Search tokens by name, symbol, or identifier.
- `get_trending_tokens`: Get tokens trending across Nebula.
- `search_accounts`: Search tracked social accounts.
- `get_token_intelligence`: Get curated intelligence and narratives.
- `get_token_mindshare`: Get token attention over time.
- `get_token_sentiment`: Get aggregate and cohort sentiment.
- `get_token_social_momentum`: Get social activity by cluster.
- `ask_nebula`: Ask the Nebula market-intelligence agent.

The server uses Streamable HTTP JSON-RPC with MCP protocol version `2025-06-18`. Tool calls use the same plans, credits, rate limits, and response shapes as the REST API.