Model Context Protocol (MCP)

Connect AI agents to your NeuralHub resources using the standard Model Context Protocol.

Overview

NeuralHub provides a native MCP server that exposes your Workspaces, Pods, and Storage as tools to AI agents. This allows you to use tools like Cursor, Claude Desktop, or custom agents to interact with your infrastructure.

Connection Details

NeuralHub uses the modern Streamable HTTP transport for MCP. This provides a single endpoint for both SSE (Server-Sent Events) and JSON-RPC messages.

Server URL

https://neuralhub.xyz/api/mcp

Authentication

You must provide your API Key as a Bearer token or query parameter.

Header: Authorization: Bearer YOUR_API_KEY
Query Param: ?apiKey=YOUR_API_KEY (Useful for some clients)

Available Tools

The MCP server dynamically exposes tools based on your resources. Common tools include:

chat_completion: Generate text using NeuralHub's LLM gateway.
neuralhub_storage_upload: Upload files to your workspace storage.
neuralhub_storage_list: List files in your workspace.
neuralhub_storage_delete: Delete files from storage.
list_workspaces: View your available workspaces.

Client Configuration

Cursor / Claude Desktop

Add a new MCP server with the following configuration:

{
  "mcpServers": {
    "neuralhub": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://neuralhub.xyz/api/mcp",
        "--header",
        "Authorization: Bearer sk-..."
      ]
    }
  }
}

Note: Some clients may support adding the URL directly. If so, use https://neuralhub.xyz/api/mcp?apiKey=sk-...