CasperAgentKit

MCP-native toolkit for building autonomous Casper agents, with a working Treasury Guard reference agent.

CasperAgentKit gives an AI host a standard Model Context Protocol interface for Casper operations: read node state, inspect blocks, query global state, evaluate treasury policy, and prepare an on-chain guard action. The reference demo shows the full agent loop: perceive, decide, prepare action, and verify the receipt.

Why This Project

The buildathon rewards practical agentic applications on Casper. A plain yield router depends on testnet DeFi liquidity that may not exist. CasperAgentKit keeps the scope controllable while staying aligned with the official AI Toolkit direction: MCP, agent skills, CSPR APIs, and transaction-producing Casper components.

The submission story is:

CasperAgentKit is an MCP-native toolkit that lets AI agents read Casper state, make decisions, and execute verified testnet transactions. We demonstrate it with a Treasury Guard Agent that autonomously enforces DeFi treasury policies on Casper Testnet.

Related MCP server: CSPR Sentinel

Alignment with Casper AI Toolkit

CasperAgentKit follows the Casper AI Toolkit direction by exposing Casper through MCP-native tools, enabling agents to query Casper state, and proving agent-driven smart contract execution with a live Testnet transaction.

It is intentionally scoped to the strongest demonstrated path: MCP tools, Casper JSON-RPC reads, a Treasury Guard agent, and a deployed Rust smart contract call on Casper Testnet.

Project Structure

src/
  agent/              Treasury Guard reference agent
  casper/             JSON-RPC client and action executor adapter
  mcp/                MCP server exposing CasperAgentKit tools
contracts/            Rust Treasury Guard smart contract and deployment notes
dashboard/            Static demo dashboard for video recording
demo/                 Scenario input and runtime receipts
docs/                 Architecture and demo scripts

Quick Start

npm install
cp .env.example .env
npm run build
npm run demo:agent

Verify the public on-chain proof:

npm run verify:proof

Smoke-test the MCP tool surface in safe dry-run mode:

npm run mcp:smoke

Start the MCP server:

npm run dev:mcp

Serve the dashboard:

npm run dashboard

The dashboard runs a local API server on http://127.0.0.1:5174/. It reads demo/runs/treasury-guard-latest.json; the Run Agent button triggers a fresh local agent run.

Build the Rust Treasury Guard contract:

npm run contract:build

MCP Tools

casper_get_node_status : Read node status from the configured Casper RPC endpoint.

casper_get_latest_block : Fetch the latest block.

casper_query_global_state : Query global state by key and optional path.

casper_get_account_balance : Read account information through CSPR.cloud when CSPR_CLOUD_API_TOKEN is configured.

treasury_guard_evaluate_policy : Evaluate a treasury scenario against guard policy.

treasury_guard_prepare_action : Produce a dry-run receipt or prepared live execution payload for the selected action.

Demo Agent

The Treasury Guard Agent reads demo/scenario.json, evaluates policy, prepares an action receipt, and writes the latest run to demo/runs/treasury-guard-latest.json.

The receipt includes llmAnalysis. By default the provider is local-rule-engine, so the demo works without secrets. To use a real OpenAI-compatible endpoint, set LLM_API_URL, LLM_API_KEY, and LLM_MODEL.

Testnet Smart Contract Integration

This kit is fully integrated with a custom Treasury Guard smart contract deployed on Casper Testnet:

• Contract Hash: hash-e575218360dd4bac37c7bc07eefbdc18fc127a97a52f47bf2e184011adbb9fa9

• Contract Package Hash: contract-package-a7675037d99636d6303ab4d1c0d2c405010f8c0afef4f60542c08b27f56fcc57

• Explorer Contract Link: Contract

• Sample Live Agent Action Transaction: 474c06c9e047ff1b629c0f4218df1ee2a156a98f8d38c5a6c926fc82cf063e4b

• Explorer Transaction Link: Transaction

• Demo Video: CasperAgentKit live demo

The agent reads risk policies, uses LLM analysis to evaluate the scenario, executes a live transaction invoking the record_guard_action entry point, and records the audit receipt.

The smart contract is implemented in Rust with casper-contract / casper-types, compiled to wasm32-unknown-unknown, and deployed through the Casper JS SDK v5 SessionBuilder().installOrUpgrade() path for Casper 2.0 Condor.

Judge Verification in 60 Seconds

1. Open the live transaction: https://testnet.cspr.live/transaction/474c06c9e047ff1b629c0f4218df1ee2a156a98f8d38c5a6c926fc82cf063e4b

2. Confirm the explorer shows:

   • action: record_guard_action

   • status: success

   • contract package hash: contract-package-a7675037d99636d6303ab4d1c0d2c405010f8c0afef4f60542c08b27f56fcc57

   • Casper Testnet transaction hash: 474c06c9e047ff1b629c0f4218df1ee2a156a98f8d38c5a6c926fc82cf063e4b

3. Run the automated proof check:

   npm install
   npm run verify:proof

4. Confirm the MCP tool surface:

   npm run mcp:smoke

Buildathon Proof Checklist

• Public GitHub repository: https://github.com/Lukeknow0/casper-agent-kit

• MCP server starts locally

• Treasury Guard demo runs from CLI and connects to live Casper Testnet

• Verified Contract address on Casper Testnet

• Verified Contract Package hash on Casper Testnet

• Live transaction hash recorded on Casper Testnet

• Demo video showing agent logs, contract address, and explorer confirmation

• GitHub Actions CI, CodeQL workflow, Dependabot config, LICENSE, and SECURITY policy