Phalcon MCP Server

This MCP server integrates with the BlockSec platform to provide blockchain transaction analysis tools via the Model Context Protocol (MCP).

Components

Tools

Transaction Analysis

• Trace

  • Trace the different calls of a transaction on a blockchain along with gas usage metrics
  • Parameters: chainId (required), transactionHash (required)

• Profile

  • Profile a transaction on a blockchain with details about the transaction, flow of funds and token information
  • Parameters: chainId (required), transactionHash (required)

• AddressLabel

  • Get human readable labels for contract addresses like tokens, protocols, and other on-chain entities
  • Parameters: chainId (required), transactionHash (required)

• BalanceChange

  • Retrieve detailed balance change information for a transaction
  • Parameters: chainId (required), transactionHash (required)

• StateChange

  • Retrieve detailed information about state changes like storage variables in contracts for a transaction
  • Parameters: chainId (required), transactionHash (required)

• TransactionOverview

  • Comprehensive overview of a transaction by aggregating data from all available analysis tools
  • Parameters: chainId (required), transactionHash (required)

Chain Information

• GetChainIdByName
  • Get the chain ID for a blockchain by name, chain, or chainSlug
  • Parameters: name (required)

Getting Started

Installation

Using Go Install

go install github.com/mark3labs/phalcon-mcp@latest

Usage

Start the MCP server:

phalcon-mcp serve

Check the version:

phalcon-mcp version

Usage with Model Context Protocol

To integrate this server with apps that support MCP:

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

Docker

Running with Docker

You can run the Phalcon MCP server using Docker:

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

Docker Configuration with MCP

To integrate the Docker image with apps that support MCP:

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

License

MIT