MCP Hub API

What is MCP Hub

HTTP server implementing Model Context Protocol (MCP) that provides AI agents with access to trading services through standardized tool calls. Protocol: JSON-RPC 2.0 over HTTP Endpoints:

Production: https://mcp.alpha.dev/api/mcp-hub/mcp
Development: https://dev.alpha.dev/api/mcp-hub/mcp

Authentication required. Contact support for API access.

Quick Start

List Available Tools

curl -X POST https://mcp.alpha.dev/api/mcp-hub/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list"
  }'

Call a Tool

curl -X POST https://mcp.alpha.dev/api/mcp-hub/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "genalpha_solchef_get_tokens_market_cap",
      "arguments": {
        "limit": 10
      }
    }
  }'

Tool Naming Convention

All tools follow the pattern: genalpha_{service}_{action} Examples:

genalpha_tim_execute_intent - Execute trading intent
genalpha_aiusd_get_portfolio - Get portfolio balance
genalpha_solchef_get_tokens_market_cap - Get token market caps

Available Services

TIM

Trading Intent ModelPrefix: genalpha_tim_*

AIUSD

Trading & PortfolioPrefix: genalpha_aiusd_*

Solchef

Market DataPrefix: genalpha_solchef_*

Integration Examples

With Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "aiusd": {
      "url": "https://mcp.alpha.dev/api/mcp-hub/mcp",
      "transport": "http",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

With Anthropic SDK

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({
  apiKey: process.env.ANTHROPIC_API_KEY,
});

const response = await client.messages.create({
  model: "claude-3-5-sonnet-20241022",
  max_tokens: 4096,
  tools: [{
    type: "custom",
    name: "mcp",
    mcp_server: {
      url: "https://mcp.alpha.dev/api/mcp-hub/mcp",
      transport: "http",
      headers: {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }],
  messages: [{
    role: "user",
    content: "What are the top 10 tokens by market cap?"
  }]
});

With MCP Inspector

Test your integration interactively:

npm install -g @modelcontextprotocol/inspector
npx @modelcontextprotocol/inspector

Configuration:

Transport: HTTP
URL: https://mcp.alpha.dev/api/mcp-hub/mcp
Auth: Bearer token required

Response Format

All tool calls return JSON-RPC 2.0 responses:

{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{...tool response data...}"
      }
    ],
    "isError": false
  }
}

Error Handling

Errors follow JSON-RPC 2.0 error format:

{
  "jsonrpc": "2.0",
  "id": 2,
  "error": {
    "code": -32600,
    "message": "Invalid request",
    "data": {
      "details": "Missing required parameter"
    }
  }
}

Authentication

MCP Hub supports Bearer token authentication:

curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://mcp.alpha.dev/api/mcp-hub/mcp

Contact support for API access credentials.

Running Locally

For local development and testing:

Prerequisites

Rust toolchain
just command runner (optional)

Start the Server

git clone https://github.com/galpha-ai/mcp-hub
cd mcp-hub

# Run with local config
just run-local

# Or with cargo
cargo run -- --config config/mcp-hub.local.yaml

Local server runs on http://127.0.0.1:3000/mcp

Local development uses passthrough authentication. Production requires valid Bearer tokens.

Tool Reference

TIM Tools

genalpha_tim_execute_intent - Execute trading intent Supports:

Immediate swaps
Prediction markets (Polymarket)
Perpetual futures (HyperLiquid)
Spot orders (HyperLiquid)
Conditional orders

AIUSD Tools

genalpha_aiusd_get_portfolio - Get account balance genalpha_aiusd_get_transactions - Get transaction history

Solchef Tools

genalpha_solchef_get_tokens_market_cap - Get top tokens by market cap Parameters:

limit (number): Number of tokens to return

Full API Reference

Complete tool catalog with parameters

Best Practices

Use Structured Logging

Enable debug logging to see tool calls:

RUST_LOG=debug cargo run

Handle Errors Gracefully

Always check isError field in responses and handle error cases.

Test with Inspector

Use MCP Inspector to test tool calls before integrating into your application.

Secure Your Tokens

Never commit Bearer tokens to version control. Use environment variables.

Getting Started

Integration

Trading API

Guides

What is MCP Hub

Quick Start

List Available Tools

Call a Tool

Tool Naming Convention

Available Services

TIM

AIUSD

Solchef

Integration Examples

With Claude Desktop

With Anthropic SDK

With MCP Inspector

Response Format

Error Handling

Authentication

Running Locally

Prerequisites

Start the Server

Tool Reference

TIM Tools

AIUSD Tools

Solchef Tools

Full API Reference

Best Practices

​What is MCP Hub

​Quick Start

​List Available Tools

​Call a Tool

​Tool Naming Convention

​Available Services

TIM

AIUSD

Solchef

​Integration Examples

​With Claude Desktop

​With Anthropic SDK

​With MCP Inspector

​Response Format

​Error Handling

​Authentication

​Running Locally

​Prerequisites

​Start the Server

​Tool Reference

​TIM Tools

​AIUSD Tools

​Solchef Tools

Full API Reference

​Best Practices

What is MCP Hub

Quick Start

List Available Tools

Call a Tool

Tool Naming Convention

Available Services

Integration Examples

With Claude Desktop

With Anthropic SDK

With MCP Inspector

Response Format

Error Handling

Authentication

Running Locally

Prerequisites

Start the Server

Tool Reference

TIM Tools

AIUSD Tools

Solchef Tools

Best Practices