---
slug: "axone"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/axone-protocol/axone-mcp@main/README.md"
repo: "https://github.com/axone-protocol/axone-mcp"
source_file: "README.md"
branch: "main"
---
# axone-mcp

> 🤖 [Axone](https://axone.xyz)’s [MCP](https://modelcontextprotocol.io/introduction) server – gateway to the dataverse for AI-powered tools

<!-- Protocol compatibility -->

[![MCP Protocol](https://img.shields.io/badge/MCP-Compatible-green)](https://modelcontextprotocol.io/introduction)
[![Smithery](https://smithery.ai/badge/@axone-protocol/axone-mcp)](https://smithery.ai/server/@axone-protocol/axone-mcp)

<!-- CI/CD -->

[![Version](https://img.shields.io/github/v/release/axone-protocol/axone-mcp?logo=github)](https://github.com/axone-protocol/axone-mcp/releases)
[![Lint](https://img.shields.io/github/actions/workflow/status/axone-protocol/axone-mcp/lint.yml?branch=main&label=lint&logo=github)](https://github.com/axone-protocol/axone-mcp/actions/workflows/lint.yml)
[![Build](https://img.shields.io/github/actions/workflow/status/axone-protocol/axone-mcp/build.yml?branch=main&label=build&logo=github)](https://github.com/axone-protocol/axone-mcp/actions/workflows/build.yml)
[![Test](https://img.shields.io/github/actions/workflow/status/axone-protocol/axone-mcp/test.yml?branch=main&label=test&logo=github)](https://github.com/axone-protocol/axone-mcp/actions/workflows/test.yml)
[![Codecov](https://img.shields.io/codecov/c/github/axone-protocol/axone-mcp?token=6NL9ICGZQS&logo=codecov)](https://codecov.io/gh/axone-protocol/axone-mcp)

<!-- Conventions -->

[![Conventional commits](https://img.shields.io/badge/Conventional%20Commits-1.0.0-yellow.svg?logo=conventionalcommits)](https://conventionalcommits.org)
[![Semantic-release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg)](https://github.com/semantic-release/semantic-release)

<!-- Community & license -->

[![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg)](https://github.com/axone-protocol/.github/blob/main/CODE_OF_CONDUCT.md)
[![License](https://img.shields.io/badge/License-BSD_3--Clause-blue.svg)](https://opensource.org/licenses/BSD-3-Clause)

## Axone’s MCP server

[Axone](https://axone.xyz)’s [MCP](https://modelcontextprotocol.io/introduction) server is a lightweight implementation that
exposes Axone’s capabilities through the standardized Model-Context Protocol.

```mermaid
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

```json
{
  "dataverse": {
    "type": "string",
    "description": "The address of the dataverse contract"
  },
  "resource": {
    "type": "string",
    "description": "The DID URI of the resource"
  }
}
```

## Installation

Get the latest [release](https://github.com/axone-protocol/axone-mcp/releases) 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](https://claude.ai/download) configuration file:

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

Flags:

- `--node-grpc`: The gRPC endpoint of the Axone node to connect to.

### Run with SSE transport

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

### Run with STDIO transport

```sh
axone-mcp serve stdio --node-grpc grpc.dentrite.axone.xyz:443
```

## Build

- Be sure you have [Golang](https://go.dev/doc/install) installed.
- [Docker](https://docs.docker.com/engine/install/) as well if you want to use the Makefile.

```sh
make build
```