Connect Cursor to Axiolex via MCP

New to Axiolex? Start with the overview or the quick start guide.

Cursor connects to Axiolex through the MCP Streamable HTTP transport. Cursor can discover the most relevant tool for a request and execute it through Axiolex’s dispatcher — without any secrets on the client.

What Cursor sees

When connected, Cursor can call three MCP tools:

• list_namespaces — list enabled tool domains and namespace descriptions (e.g. finance.market_data, retail.orders).
• axiolex_discover_tools — pass a natural-language request, get back ranked tools with their tool_id, names, descriptions, parameter schemas, endpoints, and transports.
• axiolex_execute_tool — the client selects a tool_id from discovery and passes arguments. Axiolex resolves the provider, transport, endpoint, and credentials server-side and returns a normalized result. The client never needs to know whether the tool is backed by MCP, A2A, an adapter, or an internal service.

Prerequisites

Start the Axiolex server:

git clone https://github.com/vrraj/axiolex.git && cd axiolex
make install
make start

MCP is served at http://localhost:9700/mcp.

Recommended: Streamable HTTP

Edit your Cursor MCP configuration at ~/.cursor/mcp.json:

{
  "mcpServers": {
    "axiolex": {
      "url": "http://localhost:9700/mcp"
    }
  }
}

Restart Cursor after saving the config.

Enterprise deployment

Point at the shared Axiolex URL:

{
  "mcpServers": {
    "axiolex": {
      "url": "https://axiolex.internal.corp/mcp"
    }
  }
}

The server holds all provider credentials — nothing secret lives on the client.

Alternative: stdio via npx proxy

If your Cursor configuration requires stdio transport, use the @axiolex/mcp-gateway proxy:

{
  "mcpServers": {
    "axiolex": {
      "command": "npx",
      "args": ["-y", "@axiolex/mcp-gateway", "--endpoint", "http://localhost:9700/mcp"]
    }
  }
}

See Connecting MCP Clients for the full comparison of npx proxy vs Python stdio.

Example prompts

Once connected, try prompts in Cursor Agent mode like:

• “List available namespaces in Axiolex.”
• “Create a task in Jira for fixing the login timeout bug.”
• “Research the web for analyst recommendations on NVDA.”
• “What tools are available for predicting supply risk for DDR4 memory?”
• “Get the latest stock price for AAPL.”

These are example prompts we tested with based on the tools configured in our Axiolex deployment. Connect your own MCP servers, A2A agents, and local tools, then run queries relevant to your catalog.

Notes

• Streamable HTTP requires make start to be running (Redis + Axiolex server on localhost:9700).
• The npx proxy also requires make start — the proxy connects to the HTTP endpoint. Node.js 18+ is required.
• API key rotation happens on the server only; no client reconfiguration needed.
• See Connecting MCP Clients for the generic connection architecture and other client setup guides.