3xpl

The 3xpl MCP server exposes a JSON-driven interface for interacting with the 3xpl JSON API across multiple blockchains. It provides a suite of tools (such as resolve_ens_domain, detect_blockchains, get_latest_block, get_average_fee_24h_usd, and many more) that allow large language models to query blockchain data, aggregate information, and summarize blocks, addresses, transactions, and mempool activity. The MCP server translates LLM prompts into structured API calls, aggregates results, and returns concise, usable responses that can be integrated into chatbots, assistants, or automated workflows. To start using it, run the MCP server with the uv-based command described in the configuration, ensure your API key for 3xpl is supplied if you have one, and then issue prompts that invoke the listed tools via the MCP interface.

Prerequisites:

• Python 3.10+ and uv (as part of the uvx runner) installed on your system
• Access to the repository with the 3xpl MCP code

Step-by-step installation:

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

2. Create and activate a Python virtual environment (example with uv): uv venv source .venv/bin/activate

3. Install dependencies in editable mode (as shown in the README): uv pip install -e .

4. Prepare the MCP configuration (example provided in the README): Ensure you have your THREEXPL_API_KEY ready and place it in the mcp configuration under env. If left blank, the sandbox API will be used.

5. Run the MCP server using the provided uv command (adapt to your environment): uv run --with mcp[cli] mcp run {:path_to_cloned}/3xpl_mcp/main.py

Notes:

• If the MCP server doesn’t start, you may need to provide the full path to uv in the command field.
• Replace {:path_to_cloned} with the actual path to the cloned repository on your system.

Tips and notes:

• The server exposes a variety of tools for blockchain data, including block/transaction/address overviews, mempool stats, block/transaction aggregation, and blockchain discovery (detect_blockchains).
• To use the main 3xpl API you typically need an API key; if not provided, the sandbox API with rate limits will be used as a fallback.
• Ensure the THREEXPL_API_KEY environment variable is set if you have a production key; otherwise, leave it blank to use the sandbox.
• If you encounter startup issues, verify that the path in the command matches your environment and that Python/uv are correctly installed.
• Keep your dependencies up to date to ensure compatibility with new MCP prompts and tools.