delegate-registry-mcp-server

v0.1.3

Published

7 months ago

MCP server for interacting with Delegate Registry v2

0High
0Medium
0Low

ayv8er

mcp modelcontextprotocol delegate registry ethereum web3

Delegate Registry v2 MCP Server

A Model Context Protocol (MCP) server that enables AI agents to interact with the Delegate Registry v2 smart contracts on multiple blockchain networks.

Quick Setup

Using with Claude Desktop or Cursor (via npx)

Add the following configuration to your MCP settings:

{
  "mcpServers": {
    "delegate-registry": {
      "command": "npx",
      "args": ["-y", "delegate-registry-mcp-server"],
      "env": {
        "ALCHEMY_API_KEY": "YOUR_ALCHEMY_API_KEY"
      }
    }
  }
}

Using as HTTP Server

# Install globally
npm install -g delegate-registry-mcp-server

# Run with environment variable
PORT=8080 ALCHEMY_API_KEY=your_api_key delegate-registry-mcp-server

NETWORK TOOLS

getSupportedNetworks

Get list of all supported networks for Delegate Registry v2

curl -X POST \
    http://localhost:8080/delegate-registry-v2/mcp \
    -H 'Content-Type: application/json' \
    -H 'Accept: application/json, text/event-stream' \
    -d '{
        "jsonrpc": "2.0",
        "method": "tools/call",
        "params": {
            "name": "getSupportedNetworks",
            "arguments": {}
        },
        "id": "curl-request-get-supported-networks"
    }'

getNetworkInfo

Get detailed information about a specific supported network

curl -X POST \
    http://localhost:8080/delegate-registry-v2/mcp \
    -H 'Content-Type: application/json' \
    -H 'Accept: application/json, text/event-stream' \
    -d '{
        "jsonrpc": "2.0",
        "method": "tools/call",
        "params": {
            "name": "getNetworkInfo",
            "arguments": {
                "networkIdentifier": "ethereum"
            }
        },
        "id": "curl-request-get-network-info"
    }'

WRITE TOOLS

multicall

Prepares a multicall transaction to execute multiple actions on the registry

curl -X POST \
    http://localhost:8080/delegate-registry-v2/mcp \
    -H 'Content-Type: application/json' \
    -H 'Accept: application/json, text/event-stream' \
    -d '{
        "jsonrpc": "2.0",
        "method": "tools/call",
        "params": {
            "name": "multicall",
            "arguments": {
                "network": "ethereum",
                "encodedCalls": [
                    "0x30ff3140000000000000000000000000829d550783e1495c8b8b063973437e0564bc311affffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0000000000000000000000000000000000000000000000000000000000000001",
                    "0x30ff3140000000000000000000000000829d550783e1495c8b8b063973437e0564bc311affffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0000000000000000000000000000000000000000000000000000000000000000"
                ]
            }
        },
        "id": "curl-request-multicall"
    }'

delegateAll

Prepares transaction object for delegating all rights

curl -X POST \
    http://localhost:8080/delegate-registry-v2/mcp \
    -H 'Content-Type: application/json' \
    -H 'Accept: application/json, text/event-stream' \
    -d '{
        "jsonrpc": "2.0",
        "method": "tools/call",
        "params": {
            "name": "delegateAll",
            "arguments": {
                "network": "ethereum",
                "delegatee": "0x829d550783E1495c8B8B063973437E0564bC311a",
                "rights": "0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
                "enable": true
            }
        },
        "id": "curl-request-delegate-all"
    }'

delegateContract

Prepares transaction object for delegating rights of a contract

curl -X POST \
    http://localhost:8080/delegate-registry-v2/mcp \
    -H 'Content-Type: application/json' \
    -H 'Accept: application/json, text/event-stream' \
    -d '{
        "jsonrpc": "2.0",
        "method": "tools/call",
        "params": {
            "name": "delegateContract",
            "arguments": {
                "delegatee": "0x829d550783E1495c8B8B063973437E0564bC311a",
                "contractToDelegate": "0xD4416b13d2b3a9aBae7AcD5D6C2BbDBE25686401",
                "rights": "0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
                "enable": true,
                "network": "ethereum"
            }
        },
        "id": "curl-request-delegate-contract"
    }'

delegateERC721

Prepares transaction object for delegating rights for a specific ERC721 token

curl -X POST \
    http://localhost:8080/delegate-registry-v2/mcp \
    -H 'Content-Type: application/json' \
    -H 'Accept: application/json, text/event-stream' \
    -d '{
        "jsonrpc": "2.0",
        "method": "tools/call",
        "params": {
            "name": "delegateERC721",
            "arguments": {
                "delegatee": "0x829d550783E1495c8B8B063973437E0564bC311a",
                "contractToDelegate": "0xBd3531dA5CF5857e7CfAA92426877b022e612cf8",
                "tokenId": "69420",
                "rights": "0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
                "enable": true,
                "network": "ethereum"
            }
        },
        "id": "curl-request-delegate-ERC-721"
    }'

delegateERC20

Prepares transaction object for delegating rights for an amount of ERC20 tokens

curl -X POST \
    http://localhost:8080/delegate-registry-v2/mcp \
    -H 'Content-Type: application/json' \
    -H 'Accept: application/json, text/event-stream' \
    -d '{
        "jsonrpc": "2.0",
        "method": "tools/call",
        "params": {
            "name": "delegateERC20",
            "arguments": {
                "delegatee": "0x829d550783E1495c8B8B063973437E0564bC311a",
                "contractToDelegate": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "rights": "0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
                "amount": "69",
                "network": "base"
            }
        },
        "id": "curl-request-delegate-ERC-20"
    }'

delegateERC1155

Prepares transaction object for delegating rights for an amount of an ERC1155 token

curl -X POST \
    http://localhost:8080/delegate-registry-v2/mcp \
    -H 'Content-Type: application/json' \
    -H 'Accept: application/json, text/event-stream' \
    -d '{
        "jsonrpc": "2.0",
        "method": "tools/call",
        "params": {
            "name": "delegateERC1155",
            "arguments": {
                "delegatee": "0x829d550783E1495c8B8B063973437E0564bC311a",
                "contractToDelegate": "0xD4416b13d2b3a9aBae7AcD5D6C2BbDBE25686401",
                "tokenId": "420",
                "rights": "0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
                "amount": "69",
                "network": "ethereum"
            }
        },
        "id": "curl-request-delegate-ERC-1155"
    }'

CHECK TOOLS

checkDelegateForAll

Check if delegatee is granted to act on behalf of delegator for all operations

curl -X POST \
    http://localhost:8080/delegate-registry-v2/mcp \
    -H 'Content-Type: application/json' \
    -H 'Accept: application/json, text/event-stream' \
    -d '{
        "jsonrpc": "2.0",
        "method": "tools/call",
        "params": {
            "name": "checkDelegateForAll",
            "arguments": {
                "delegatee": "0xDd555E39F07f46F1dD7c39034Ce19A094CcA710f",
                "delegator": "0x9f761675CfAE369dA99Ef0B2A2515EF215077087",
                "rights": "0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
                "network": "ethereum"
            }
        },
        "id": "curl-request-check-delegate-all"
    }'

checkDelegateForContract

Check if delegatee is granted to act on behalf of delegator for a specific contract

curl -X POST \
    http://localhost:8080/delegate-registry-v2/mcp \
    -H 'Content-Type: application/json' \
    -H 'Accept: application/json, text/event-stream' \
    -d '{
        "jsonrpc": "2.0",
        "method": "tools/call",
        "params": {
            "name": "checkDelegateForContract",
            "arguments": {
                "delegatee": "0xDd555E39F07f46F1dD7c39034Ce19A094CcA710f",
                "delegator": "0x9f761675CfAE369dA99Ef0B2A2515EF215077087",
                "contractToDelegate": "0xD4416b13d2b3a9aBae7AcD5D6C2BbDBE25686401",
                "rights": "0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
                "network": "ethereum"
            }
        },
        "id": "curl-request-check-delegate-for-contract"
    }'

checkDelegateForERC721

Check if delegatee is granted to act on behalf of delegator for a specific ERC721 token

curl -X POST \
    http://localhost:8080/delegate-registry-v2/mcp \
    -H 'Content-Type: application/json' \
    -H 'Accept: application/json, text/event-stream' \
    -d '{
        "jsonrpc": "2.0",
        "method": "tools/call",
        "params": {
            "name": "checkDelegateForERC721",
            "arguments": {
                "delegatee": "0xDd555E39F07f46F1dD7c39034Ce19A094CcA710f",
                "delegator": "0x9f761675CfAE369dA99Ef0B2A2515EF215077087",
                "contractToDelegate": "0xD4416b13d2b3a9aBae7AcD5D6C2BbDBE25686401",
                "tokenId": "3",
                "rights": "0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
                "network": "ethereum"
            }
        },
        "id": "curl-request-check-delegate-for-ERC-721"
    }'

checkDelegateForERC20

Check if delegatee is granted to act on behalf of delegator for an amount of ERC20 tokens

curl -X POST \
    http://localhost:8080/delegate-registry-v2/mcp \
    -H 'Content-Type: application/json' \
    -H 'Accept: application/json, text/event-stream' \
    -d '{
        "jsonrpc": "2.0",
        "method": "tools/call",
        "params": {
            "name": "checkDelegateForERC20",
            "arguments": {
                "delegatee": "0xDd555E39F07f46F1dD7c39034Ce19A094CcA710f",
                "delegator": "0x9f761675CfAE369dA99Ef0B2A2515EF215077087",
                "contractToDelegate": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "rights": "0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
                "network": "ethereum"
            }
        },
        "id": "curl-request-check-delegate-for-ERC-20"
    }'

checkDelegateForERC1155

Check if delegatee is granted to act on behalf of delegator for an amount of ERC1155 tokens

curl -X POST \
    http://localhost:8080/delegate-registry-v2/mcp \
    -H 'Content-Type: application/json' \
    -H 'Accept: application/json, text/event-stream' \
    -d '{
        "jsonrpc": "2.0",
        "method": "tools/call",
        "params": {
            "name": "checkDelegateForERC1155",
            "arguments": {
                "delegatee": "0xDd555E39F07f46F1dD7c39034Ce19A094CcA710f",
                "delegator": "0x9f761675CfAE369dA99Ef0B2A2515EF215077087",
                "contractToDelegate": "0xD4416b13d2b3a9aBae7AcD5D6C2BbDBE25686401",
                "tokenId": "4",
                "rights": "0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
                "network": "ethereum"
            }
        },
        "id": "curl-request-check-delegate-for-ERC-1155"
    }'

ENUMERATION TOOLS

getIncomingDelegations

Get all delegations where the address is the delegate

curl -X POST \
    http://localhost:8080/delegate-registry-v2/mcp \
    -H 'Content-Type: application/json' \
    -H 'Accept: application/json, text/event-stream' \
    -d '{
        "jsonrpc": "2.0",
        "method": "tools/call",
        "params": {
            "name": "getIncomingDelegations",
            "arguments": {
                "address": "0x64bb1dB59ad45cDC4Ae7cF2C87a6183A22F50447",
                "network": "ethereum"
            }
        },
        "id": "curl-request-get-incoming-delegations"
    }'

getOutgoingDelegations

Get all delegations made by the address

curl -X POST \
    http://localhost:8080/delegate-registry-v2/mcp \
    -H 'Content-Type: application/json' \
    -H 'Accept: application/json, text/event-stream' \
    -d '{
        "jsonrpc": "2.0",
        "method": "tools/call",
        "params": {
            "name": "getOutgoingDelegations",
            "arguments": {
                "address": "0x64bb1dB59ad45cDC4Ae7cF2C87a6183A22F50447",
                "network": "ethereum"
            }
        },
        "id": "curl-request-get-outgoing-delegations"
    }'

getIncomingDelegationHashes

Get all incoming delegation hashes for an address

curl -X POST \
    http://localhost:8080/delegate-registry-v2/mcp \
    -H 'Content-Type: application/json' \
    -H 'Accept: application/json, text/event-stream' \
    -d '{
        "jsonrpc": "2.0",
        "method": "tools/call",
        "params": {
            "name": "getIncomingDelegationHashes",
            "arguments": {
                "address": "0x64bb1dB59ad45cDC4Ae7cF2C87a6183A22F50447",
                "network": "ethereum"
            }
        },
        "id": "curl-request-get-incoming-delegation-hashes"
    }'

getOutgoingDelegationHashes

Get all outgoing delegation hashes for an address

curl -X POST \
    http://localhost:8080/delegate-registry-v2/mcp \
    -H 'Content-Type: application/json' \
    -H 'Accept: application/json, text/event-stream' \
    -d '{
        "jsonrpc": "2.0",
        "method": "tools/call",
        "params": {
            "name": "getOutgoingDelegationHashes",
            "arguments": {
                "address": "0xDd555E39F07f46F1dD7c39034Ce19A094CcA710f",
                "network": "ethereum"
            }
        },
        "id": "curl-request-get-outgoing-delegation-hashes"
    }'

getDelegationsFromHashes

Get delegation details from delegation hashes

curl -X POST \
    http://localhost:8080/delegate-registry-v2/mcp \
    -H 'Content-Type: application/json' \
    -H 'Accept: application/json, text/event-stream' \
    -d '{
        "jsonrpc": "2.0",
        "method": "tools/call",
        "params": {
            "name": "getDelegationsFromHashes",
            "arguments": {
                "delegationHashes": [
                    "0xdd1824ba0dbecf7312cdbcb7b14623b83495361516992de10263ba2b5acd6501",
                    "0x3c74aa4aa0eaa7c8fc640e59deeec899c446fc120b374b879dc8d2035b94c001"
                ],
                "network": "ethereum"
            }
        },
        "id": "curl-request-get-delegations-from-hashes"
    }'

Supported Networks

Mainnet Networks

Ethereum Mainnet (ethereum)
Apechain (apechain)
Arbitrum One (arbitrum)
Arbitrum Nova (arbitrum_nova)
Avalanche (avalanche)
Base (base)
Blast (blast)
BNB Chain (bnb)
Canto (canto)
Celo (celo)
Fantom (fantom)
Gnosis (gnosis)
Hychain (hychain)
Linea (linea)
Mantle (mantle)
Moonbeam (moonbeam)
Moonriver (moonriver)
Optimism (optimism)
Polygon (polygon)
Polygon zkEVM (polygon_zkevm)
Plume (plume)
Ronin (ronin)
Sanko (sanko)
Scroll (scroll)
Sei (sei)
Shape (shape)
Taiko (taiko)
Xai (xai)
Zetachain (zetachain)
Zora (zora)
Abstract (abstract)
zkSync Era (zksync_era)
Treasure (treasure)

Testnet Networks

Ethereum Sepolia (ethereum_sepolia)
Ethereum Holesky (ethereum_holesky)
Abstract Sepolia (abstract_sepolia)
Base Sepolia (base_sepolia)
Berachain Bepolia (berachain_artio)
Ronin Testnet (ronin_testnet)

Environment Variables

ALCHEMY_API_KEY (required): Your Alchemy API key for blockchain access
PORT (optional): HTTP server port (default: 8080)

Publishing to npm

npm version patch
npm publish