Phalcon

You can integrate blockchain transaction analysis into your AI workflows with the Phalcon MCP Server. It exposes a set of tools that analyze transactions, extract chain information, and provide consolidated insights, all accessible through the Model Context Protocol (MCP). This lets you build intelligent agents that understand on-chain activity, detect patterns, and surface actionable details across multiple blocks and tokens.

How to use

You connect an MCP client to the Phalcon MCP Server and call the available tools to analyze blockchain transactions. Start by launching the server in your preferred mode, then configure your MCP client to expose the server under a unique name. Use the provided tools to trace transaction calls, profile funds and token data, label addresses, track balance changes, inspect state changes, and generate a comprehensive TransactionOverview. You can also resolve chain identifiers by name to ensure requests target the correct network.

How to install

Prerequisites you need before installing depend on your chosen runtime. You will work with a Go-based server and may also run the server via Docker.

Code install and run options

# Install the Phalcon MCP server (Go install path)
go install github.com/mark3labs/phalcon-mcp@latest

# Start the MCP server directly
phalcon-mcp serve

# Check the version to verify installation
phalcon-mcp version

Docker installation and run

If you prefer running via Docker, use the following configuration to start the MCP server and expose it to MCP clients.

Docker run example

docker run -i --rm ghcr.io/mark3labs/phalcon-mcp:latest serve

MCP JSON configuration examples

Configure your MCP client to connect to the Phalcon MCP Server using the MCP configuration structure. The examples below show two valid ways to start the server under MCP control. Use one or both as needed.

{
  "mcpServers": {
    "phalcon": {
      "command": "phalcon-mcp",
      "args": ["serve"]
    }
  }
}

{
  "mcpServers": {
    "phalcon": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/mark3labs/phalcon-mcp:latest",
        "serve"
      ]
    }
  }
}

Available tools

Trace

Trace the different calls of a transaction on a blockchain along with gas usage metrics. Requires chainId and transactionHash.

Profile

Profile a transaction detailing transaction, flow of funds, and token information. Requires chainId and transactionHash.

AddressLabel

Get human readable labels for contract addresses like tokens, protocols, and other on-chain entities. Requires chainId and transactionHash.

BalanceChange

Retrieve detailed balance change information for a transaction. Requires chainId and transactionHash.

StateChange

Retrieve detailed information about state changes such as storage variables in contracts for a transaction. Requires chainId and transactionHash.

TransactionOverview

Provide a comprehensive overview of a transaction by aggregating data from all available analysis tools. Requires chainId and transactionHash.

GetChainIdByName

Get the chain ID for a blockchain by name, chain, or chainSlug.