allora

The Allora MCP Server exposes a standardized interface for querying Allora prediction markets data via the Model Context Protocol (MCP). Once the server is running, clients can subscribe to real-time updates and request specific inferences and topics through the MCP endpoints. The server exposes two primary endpoints: GET /sse for establishing an SSE-based MCP communication stream and POST /messages for sending MCP messages to interact with the data. Point your MCP client or LLM tooling to http://localhost:3001/sse to start receiving data.

Available Tools include: list_all_topics to fetch all Allora topics, and get_inference_by_topic_id to retrieve inference data for a given topic ID. These tools enable you to discover available markets and fetch current predictions or inference data for any topic. You can integrate these tools into your prompts or automated workflows to retrieve up-to-date Allora market information and feed it into your AI systems or decision workflows.

Prerequisites:

• Docker or Node.js 18+ (choose one method below)
• An Allora API key (sign up at https://developer.allora.network)

Option A: Docker (recommended)

1. Ensure Docker is installed and running.
2. Run the MCP server image (replace with your desired port if needed): docker run -p 3001:3001 -e PORT=3001 -e ALLORA_API_KEY=your_api_key alloranetwork/mcp-server
3. The server will be available at http://localhost:3001/sse for MCP clients.

Option B: npx (Node.js-based, if you prefer running directly from npm registry)

1. Ensure Node.js 18+ is installed.
2. Run: npx @alloralabs/mcp-server
3. Follow the console output to determine the listening port (default 3001).

Option C: Node.js (local source code)

1. Ensure Node.js 18+ is installed.
2. Clone the repository and install dependencies: npm install
3. Start the server: npm run start
4. Access the MCP endpoints at http://localhost:3001/sse (adjust port if needed).

Prerequisites recap:

• Docker or Node.js 18+ installed
• Allora API key
• Network access to Allora services

• The ALLORA_API_KEY must be kept secret; do not share in public repos.
• If running behind a reverse proxy, ensure proper CORS and SSE support for /sse endpoint.
• The server is designed to listen on port 3001 by default; adjust the PORT environment variable if necessary.
• If you encounter connection errors, verify that the API key is valid and that the Allora service is reachable from your environment.
• You can use either Docker or npx/Node.js to run the MCP server; choose the method that best fits your deployment workflow.