CRE MCP Server

CRE MCP Server

MCP server for the Chainlink Runtime Environment (CRE) — wraps the CRE CLI and SDK as 30 tools and 10 resources over the Model Context Protocol.

Build, simulate, deploy, and manage CRE workflows from any MCP client (Claude Code, Claude Desktop, Cursor, etc.).

Features

• 30 MCP tools — full CRE lifecycle: auth, project scaffolding, workflow management, secrets, code generation, account keys, and Solidity contract scaffolding
• 10 MCP resources — architecture docs, SDK reference, config schemas, contract templates, forwarder addresses
• Solidity support — scaffold IReceiver contracts, typed consumer contracts, and CCIP receivers
• Streamable HTTP transport — stateful sessions via Express on port 3200

Prerequisites

• Node.js 18+
• CRE CLI: curl -sSfL https://raw.githubusercontent.com/smartcontractkit/cre-cli/main/install/install.sh | bash
• Bun (required by CRE CLI for WASM compilation): brew install oven-sh/bun/bun

Quick Start

git clone https://github.com/Midwest-AI-Solutions/cremcp.git
cd cremcp
npm install
npm run dev

The server starts at http://localhost:3200 with:

• MCP endpoint: http://localhost:3200/mcp
• Health check: http://localhost:3200/health

MCP Client Configuration

Claude Code (~/.claude.json)

{
  "mcpServers": {
    "cre": {
      "type": "http",
      "url": "http://localhost:3200/mcp"
    }
  }
}

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "cre": {
      "type": "http",
      "url": "http://localhost:3200/mcp"
    }
  }
}

Tools

| Category | Tools | Description | |----------|-------|-------------| | Auth | cre_login, cre_logout, cre_whoami | Chainlink platform authentication | | Project | cre_init, cre_build, cre_version, cre_update, cre_generate_bindings | Project scaffolding and build | | Workflow | cre_workflow_simulate, cre_workflow_deploy, cre_workflow_activate, cre_workflow_pause, cre_workflow_delete | Full workflow lifecycle | | Secrets | cre_secrets_create, cre_secrets_update, cre_secrets_delete, cre_secrets_list, cre_secrets_execute | DON-encrypted secrets management | | Codegen | cre_scaffold_trigger, cre_scaffold_capability, cre_scaffold_handler | TypeScript workflow code generation | | Docs | cre_get_docs, cre_list_capabilities, cre_list_triggers | Documentation and reference | | Account | cre_account_link_key, cre_account_list_key, cre_account_unlink_key | Wallet key management | | Solidity | cre_scaffold_receiver, cre_scaffold_consumer, cre_scaffold_ccip_receiver | On-chain contract scaffolding |

Resources

| URI | Description | |-----|-------------| | cre://docs/overview | CRE architecture overview | | cre://docs/sdk-reference | TypeScript SDK quick reference | | cre://docs/forwarder-addresses | KeystoneForwarder addresses by chain | | cre://docs/solidity-integration | End-to-end on-chain integration guide | | cre://contracts/ireceiver | IReceiver interface specification | | cre://contracts/consumer-template | Annotated consumer contract template | | cre://config/workflow-yaml | Workflow YAML schema | | cre://config/secrets-yaml | Secrets YAML schema | | cre://config/project-yaml | Project YAML schema | | cre://templates/workflow-ts | Minimal workflow TypeScript template |

Supported Trigger Types

| Type | Use Case | |------|----------| | cron | Time-based scheduling | | streams | Data Streams price updates | | mercury | Mercury feed updates | | log-trigger | EVM log events | | on-demand | API-initiated | | http | Incoming webhook |

Supported Capability Types

| Type | Use Case | |------|----------| | custom-compute | Arbitrary WASM logic | | write-evm | Write to EVM chains | | data-feeds-read | Read Chainlink price feeds | | streams-lookup | Fetch Data Streams reports | | chain-reader | Read on-chain state | | http-client | HTTP requests with DON consensus | | consensus | Aggregate results across DON nodes |

Architecture

src/
├── index.ts              # Express server + Streamable HTTP transport
├── server.ts             # McpServer instance + tool/resource registration
├── lib/
│   ├── cli-check.ts      # CRE CLI availability detection
│   ├── cli-runner.ts     # child_process.spawn wrapper
│   └── output-parser.ts  # Tool response formatting
├── tools/
│   ├── index.ts          # Tool module registration
│   ├── auth.ts           # Login, logout, whoami
│   ├── project.ts        # Init, build, version, update, generate-bindings
│   ├── workflow.ts       # Simulate, deploy, activate, pause, delete
│   ├── secrets.ts        # CRUD + execute for DON secrets
│   ├── codegen.ts        # Trigger, capability, handler scaffolding
│   ├── docs.ts           # Documentation retrieval
│   ├── account.ts        # Wallet key management
│   └── solidity.ts       # Solidity contract scaffolding
└── resources/
    ├── index.ts          # Resource module registration
    ├── docs.ts           # Overview + SDK reference
    ├── templates.ts      # Config schemas + workflow template
    └── solidity.ts       # IReceiver, consumer, forwarder addresses, integration guide

Development

npm run dev        # Start with hot reload (tsx --watch)
npm run build      # Compile TypeScript
npm start          # Run compiled JS
npm run typecheck  # Type check without emitting

Environment Variables

| Variable | Default | Description | |----------|---------|-------------| | PORT | 3200 | Server port | | CRE_CLI_PATH | ~/.cre/bin/cre | Path to CRE CLI binary |

License

MIT