Phalcon MCP

🚀 Phalcon MCP Server

This MCP server integrates with the BlockSec platform, offering blockchain transaction analysis tools through the Model Context Protocol (MCP).

🚀 Quick Start

📦 Installation

Install with Go

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

💻 Usage Examples

Basic Usage

Start the MCP server:

phalcon-mcp serve

Check the version:

phalcon-mcp version

Advanced Usage

To integrate this server with MCP-compatible applications:

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

Docker

Run with Docker

You can run the Phalcon MCP server using Docker:

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

Docker Configuration for MCP Integration

To integrate the Docker image with MCP-compatible applications:

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

✨ Features

Tools

Transaction Analysis

• Trace

  • Trace different calls of a transaction on the blockchain and its gas usage.
  • Parameters: chainId (required), transactionHash (required).

• Profile

  • Analyze detailed information of a transaction, including fund flow and token information.
  • Parameters: chainId (required), transactionHash (required).

• AddressLabel

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

• BalanceChange

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

• StateChange

  • Get detailed information about the state changes of a transaction, such as storage variables in a contract.
  • Parameters: chainId (required), transactionHash (required).

• TransactionOverview

  • Provide a 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 by name, chain, or chainSlug.
  • Parameters: name (required).

📄 License

MIT