MCP Server

Connect an MCP-compatible agent to Nebula and query live financial social intelligence using your API key.

Quickstart

Create a key in the API Portal, then connect your client to:

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

Every MCP tool uses the same plans, credits, rate limits, and response data as the REST API.

Authentication

Endpoint	`https://nebula-api.hiddensystems.ai/mcp`
Header	`X-API-Key: YOUR_API_KEY`
Alternative	`Authorization: Bearer YOUR_API_KEY`
Transport	Streamable HTTP

Connect Claude Code

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

Restart the Claude Code session after adding the server, then ask it to list trending tokens.

Connect Cursor

Add Nebula to your Cursor MCP configuration:

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

Other MCP clients

Use the same Streamable HTTP URL and API-key header in any client that supports remote MCP servers with custom headers.

URL: https://nebula-api.hiddensystems.ai/mcp
Header: X-API-Key: YOUR_API_KEY

Tools and permissions

The first release exposes eight read-only tools.

`search_tokens`	Search 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 social attention over time
`get_token_sentiment`	Get aggregate and cohort sentiment
`get_token_social_momentum`	Get activity by social cluster
`ask_nebula`	Ask the Nebula agent a market question

Troubleshooting

401: the API key is missing, invalid, or revoked.
403: the requested signal is not included in the key's plan.
429: the key has reached its rate limit.
If tools do not appear, restart the client after saving its MCP configuration.