Use Tenzro with Claude via MCP

What You'll Build

By the end of this tutorial, you'll have Claude connected to the Tenzro testnet via the Model Context Protocol (MCP) and will have performed a complete workflow: created a wallet, requested testnet tokens, checked your balance, and registered a decentralized identity. All through natural language conversations with Claude.

Prerequisites

• Claude Desktop or Claude Code installed
• Internet connection (all operations use live testnet endpoints)

Configure the MCP Server

Tenzro runs a public MCP server at https://mcp.tenzro.network/mcp using Streamable HTTP transport. This server exposes 20 tools that allow Claude to interact with the Tenzro blockchain, manage identities, process payments, and query AI models.

For Claude Desktop: Add the following to your claude_desktop_config.json file:

{
  "mcpServers": {
    "tenzro": {
      "url": "https://mcp.tenzro.network/mcp"
    }
  }
}

For Claude Code: Run this command in your terminal:

claude mcp add tenzro --transport streamable-http https://mcp.tenzro.network/mcp

After configuration, restart Claude Desktop or Claude Code to load the new server.

Step 1: Check Node Status

First, verify that Claude can connect to the Tenzro testnet. Ask Claude in natural language:

What's the current status of the Tenzro node?

Claude will call the get_node_status tool and return a response like:

{
  "status": "healthy",
  "block_height": 12543,
  "peer_count": 8,
  "uptime_seconds": 345600,
  "chain_id": 1337
}

This confirms that the node is running and accepting connections.

Step 2: Create a Wallet

Next, create a new wallet. Ask Claude:

Create a new wallet on Tenzro

Claude will call create_wallet and return:

{
  "address": "0x8f3a2b5c4d1e6a9b7c2f8d3e5a1b6c4d2e9f7a3b",
  "public_key": "0x04a5b3c2d8e9f1a4b7c3d6e2f9a5b8c1d4e7f2a9...",
  "key_type": "Ed25519"
}

Important:Save this address—you'll need it for the next steps. In production, you'd also save the private key securely, but the MCP tools handle key management internally for this tutorial.

Step 3: Request Testnet Tokens

Now request tokens from the faucet. Ask Claude (replacing the address with yours):

Request testnet tokens for 0x8f3a2b5c4d1e6a9b7c2f8d3e5a1b6c4d2e9f7a3b

The request_faucettool will be called, and you'll receive:

{
  "success": true,
  "amount": "100000000000000000000",
  "tx_hash": "0x3a5e8d9c2b7f4a1e6d3c9b5a8f2e7d4c1b9a6e3f",
  "message": "100 TNZO sent to your address"
}

The faucet distributes 100 TNZO per request with a 24-hour cooldown per address.

Step 4: Check Your Balance

Verify the tokens arrived by asking:

What's my balance at 0x8f3a2b5c4d1e6a9b7c2f8d3e5a1b6c4d2e9f7a3b?

The get_balance tool returns:

{
  "address": "0x8f3a2b5c4d1e6a9b7c2f8d3e5a1b6c4d2e9f7a3b",
  "balance": "100000000000000000000",
  "balance_formatted": "100.0 TNZO"
}

Your wallet now has 100 TNZO to use for transactions, staking, or paying for AI inference.

Step 5: Register an Identity

Tenzro implements TDIP (Tenzro Decentralized Identity Protocol) for unified human and machine identities. Register a human identity:

Register a human identity with display name 'Alice'

Claude calls register_identity and returns:

{
  "did": "did:tenzro:human:a3f5c8e1-4b2d-4e9a-8c7f-3d5e2a1b9c4d",
  "identity_type": "Human",
  "display_name": "Alice",
  "wallet_address": "0x8f3a2b5c4d1e6a9b7c2f8d3e5a1b6c4d2e9f7a3b",
  "kyc_tier": "Unverified"
}

Every identity gets an auto-provisioned 2-of-3 threshold MPC wallet with no seed phrases required. The DID follows the W3C Decentralized Identifiers standard.

Step 6: Resolve the Identity

Finally, verify the identity was registered correctly:

Resolve the DID did:tenzro:human:a3f5c8e1-4b2d-4e9a-8c7f-3d5e2a1b9c4d

The resolve_did tool returns the full identity document:

{
  "did": "did:tenzro:human:a3f5c8e1-4b2d-4e9a-8c7f-3d5e2a1b9c4d",
  "identity_type": "Human",
  "display_name": "Alice",
  "wallet_address": "0x8f3a2b5c4d1e6a9b7c2f8d3e5a1b6c4d2e9f7a3b",
  "kyc_tier": "Unverified",
  "public_key": "0x04a5b3c2d8e9f1a4b7c3d6e2f9a5b8c1d4e7f2a9...",
  "created_at": "2026-03-24T10:30:00Z",
  "controlled_machines": []
}

You now have a complete on-chain identity that can control machine agents, verify credentials, and participate in governance.

What's Next

You've successfully connected Claude to the Tenzro testnet and performed core operations. Here are some next steps to explore:

• Create a machine identity and set delegation scopes for autonomous agents
• Transfer TNZO between addresses using the send_transaction tool
• Query available AI models with list_models and request inference
• Create payment challenges using MPP or x402 protocols
• Bridge tokens to other chains using LayerZero or Chainlink CCIP adapters
• Verify zero-knowledge proofs for privacy-preserving transactions

For more advanced workflows, check out these tutorials:

• Create an Agentic Wallet — Build an autonomous agent with MPC wallet and delegation scopes
• Payments with MPP — Implement HTTP 402-based machine payments