3xpl.com JSON API MCP server

Overview

3xpl API in form of a Model Context Protocol (MCP) server.

Allows LLMs to interact with data on 48 blockchains.

This repository can also be an example of 3xpl JSON API usage, see details in the code.

List of available tools

| name | description | status | |---------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------|--------| | resolve_ens_domain | resolves an ENS domain to a regular address | ✅ | | detect_blockchains | retrieve a list of blockchains on which a transaction/address is present | ✅ | | get_latest_block | get latest block height in specified blockchain | ✅ | | get_average_fee_24h_usd | retrieves average transaction fee for last 24 hours in specified blockchain in US dollars. | ✅ | | get_mempool_events_count | get the number of unconfirmed events(transfers, inputs/outputs, not transactions) at the moment in the memory pool of provided blockchain | ✅ | | get_events_count_24h | retrieve number of events(transfers, inputs/outputs, not whole transactions) in last 24h for provided blockchain | ✅ | | get_block_overview | extract short summary about a block in provided blockchain | ✅ | | get_address_overview | extract short summary about an address in provided blockchain | ✅ | | get_transaction_overview | extract short summary about a transaction in provided blockchain(to be improved) | ✅ | | list_blockchains_and_modules | get a list of blockchains and their modules with module descriptions | ✅ | | aggregate_block_transactions | aggregate transactions in a block | ✅ | | aggregate_transaction_transfers | aggregate individual transfers in a transactions | ✅ | | aggregate_address_balances | aggregate balances for an address with | ✅ | | aggregate_address_transactions | aggregate confirmed transactions for an address | ✅ | | aggregate_address_mempool | aggregate pending transactions for an address | ✅ |

List of available prompts

| name | description | |---------------------|---------------------------------------------------------------------------| | get_blockchain_info | makes LLM dig deeper into data for providing the most fulfilled response. |

Installation

# get the repository
git clone https://github.com/exekerey/3xpl-mcp.git
cd 3xpl-mcp

# create and activate virtual environment
uv venv
source .venv/bin/activate

# install dependencies
uv pip install -e .

MCP configuration:

{
  "mcpServers": {
    "3xpl_API": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "{:path_to_cloned}/3xpl_mcp/main.py"
      ],
      "env": {
        "THREEXPL_API_KEY": ""
      }
    }
  }
}

*Note: Set your API key from 3xpl to use the main API. If the THREEXPL_API_KEY field in the config file is left blank, the MCP server will use the sandbox API, which has rate limits.

*Note 2: if MCP server doesn't start you might need to provide full path to uv in the command field.

Contribution

Feel free to open issues for bugs or suggestions. Pull requests are also welcome – just make sure to provide description of your changes.