axone-mcp

README

axone-mcp

🤖 Axone’s MCP server – gateway to the dataverse for AI-powered tools

Axone’s MCP server

Axone’s MCP server is a lightweight implementation that exposes Axone’s capabilities through the standardized Model-Context Protocol.

flowchart LR
    classDef actor stroke:#808
    classDef system stroke:#0ff
    classDef resource stroke:#f00

    actor:::actor@{ shape: stadium, label: "Host with MCP Client<br>(Claude, IDEs, Tools)" }
    mcpServer:::system@{ shape: rounded, label: "Axone<br>MCP server" }
    axone:::system@{ shape: das, label: "🔗 Axone chain" }


    actor -- query --> mcpServer

    mcpServer -. query .-> axone

Available tools

get_resource_governance_code

Get the governance code attached to the given resource (if any).

Input schema

{
  "resource": {
    "type": "string",
    "description": "The resource DID to get the governance code for."
  }
}

Installation

Get the latest release and put it in your $PATH or somewhere you can easily access.

Usage with Claude

Add this to your claude_desktop_config.json Claude Desktop configuration file:

{
  "mcpServers": {
    "axone": {
      "command": "axone-mcp",
      "args": [
        "serve",
        "stdio",
        "--node-grpc",
        "grpc.dentrite.axone.xyz:443",
        "--dataverse-addr",
        "axone1xt4ahzz2x8hpkc0tk6ekte9x6crw4w6u0r67cyt3kz9syh24pd7scvlt2w"
      ]
    }
  }
}

Flags:

• --node-grpc: The gRPC endpoint of the Axone node to connect to.
• --dataverse-addr: The dataverse address to use.

Run with SSE transport

axone-mcp serve sse --listen-addr localhost:8080 --node-grpc grpc.dentrite.axone.xyz:443 --dataverse-addr axone1xt4ahzz2x8hpkc0tk6ekte9x6crw4w6u0r67cyt3kz9syh24pd7scvlt2w

Run with STDIO transport

axone-mcp serve stdio --node-grpc grpc.dentrite.axone.xyz:443 --dataverse-addr axone1xt4ahzz2x8hpkc0tk6ekte9x6crw4w6u0r67cyt3kz9syh24pd7scvlt2w

Build

• Be sure you have Golang installed.
• Docker as well if you want to use the Makefile.

make build