Viatoris MCP Server

A Model Context Protocol server that gives Claude Desktop, Claude Code, Cursor, and any other MCP-compatible client direct access to Viatoris — create agents, list them, verify other agents, and check reputation, all from inside your AI client of choice.

Configure in Claude Desktop

Add the following to your claude_desktop_config.json (Claude → Settings → Developer → Edit Config):

{
  "mcpServers": {
    "viatoris": {
      "command": "npx",
      "args": ["@viatorisai/mcp-server"],
      "env": {
        "VIATORIS_API_KEY": "at_live_..."
      }
    }
  }
}

Restart Claude Desktop. You'll see the Viatoris tools appear in the tool picker.

Configure in Claude Code

claude mcp add viatoris npx @viatorisai/mcp-server --env VIATORIS_API_KEY=at_live_...

Configure in Cursor

Add to your Cursor MCP settings (~/.cursor/mcp.json or via Settings → MCP):

{
  "mcpServers": {
    "viatoris": {
      "command": "npx",
      "args": ["@viatorisai/mcp-server"],
      "env": {
        "VIATORIS_API_KEY": "at_live_..."
      }
    }
  }
}

Get an API key

Sign up at dashboard.viatoris.ai and copy your API key from the Settings page. The full quickstart is at viatoris.ai/quickstart.

Available tools

| Tool | Description | |---|---| | create_agent | Create a new AI agent with a cryptographic identity (DID + Ed25519 key pair). Returns the private key — save it. | | list_agents | List every agent in your organization. | | verify_agent | Check another agent's identity, status, reputation, and compliance frameworks. Public endpoint — works for any DID, not just yours. | | get_reputation | Fetch the full reputation profile and trust signals for an agent. | | list_receipts | List recent signed action receipts, optionally filtered by agent. | | submit_receipt_info | Explains how to submit signed receipts (must be done via the SDK). |

Why can't I submit receipts from the MCP server?

Submitting a receipt requires the agent's Ed25519 private key to produce a JWS signature, and the MCP server intentionally never holds private keys. Receipt signing belongs inside your agent process — use @viatorisai/sdk (TypeScript) or viatorisai (Python) for that. Run submit_receipt_info for a copy-pasteable example.

Configuration

| Env var | Default | Notes | |---|---|---| | VIATORIS_API_KEY | (required) | Get one at dashboard.viatoris.ai | | VIATORIS_BASE_URL | https://api.viatoris.ai | Passport / verify / orgs service | | VIATORIS_RECEIPT_URL | https://api-receipts.viatoris.ai | Receipt service | | VIATORIS_REPUTATION_URL | https://api-reputation.viatoris.ai | Reputation service |

If your environment is blocked by Cloudflare Bot Fight Mode (typical for server-to-server deploys), override these with the Railway direct URLs:

VIATORIS_BASE_URL=https://agent-trust-infra-production.up.railway.app
VIATORIS_RECEIPT_URL=https://receipt-service-production.up.railway.app
VIATORIS_REPUTATION_URL=https://reputation-service-production.up.railway.app

Documentation

Full Viatoris guide at viatoris.ai/quickstart.

Questions? Email [email protected].

License

MIT