Herd Agent

Herd connects AI agents to on-chain data and actions through multiple interfaces. Query contracts, decode transactions, analyze wallets, build/simulate actions, and query onchain data — all using natural language. The MCP server, CLI, and TypeScript SDK all expose the same set of tools and capabilities.

MCP Install

Add Herd as an MCP server to your AI coding client.

claude mcp add --transport http herd-mcp https://mcp.herd.eco/v1

Claude Code: claude mcp add --transport http herd-mcp https://mcp.herd.eco/v1
Cursor: Add via Settings → MCP
Codex: Add via MCP configuration

Authenticate

Open /mcp in your IDE (Claude, Cursor, or Codex)
Find herd-mcp in the MCP list
Click Authenticate to complete the OAuth flow
Sign in with your Herd account at herd.eco

Manage

# List configured MCPs (Claude Code)
claude mcp list

# Remove
claude mcp remove herd-mcp

CLI Install

Install the Herd CLI for terminal-based access to all Herd tools.

curl -fsSL https://raw.githubusercontent.com/herd-labs/herd-cli/main/install.sh | bash

Authenticate

herd login

This opens a browser for OAuth authentication. On successful login, the CLI automatically provisions an API key stored at ~/.herd/credentials.json. This API key can also be used with the TypeScript SDK.

Commands

Group	Commands	Description
`herd contract`	`metadata`, `deployed`, `roles`, `diff`	Contract info, deployments, roles, version diffs
`herd tx`	`query`, `latest`	Transaction inspection, recent activity
`herd wallet`	`overview`, `tokens`, `transactions`	Wallet profiling, token activity, tx history
`herd bookmarks`	`list`, `update`	Manage saved items
`herd hal`	`create`, `get`, `search`, `update`, `delete`, `simulate`, `simulate-existing`	HAL actions, adapters, code blocks, collections
`herd docs`	`read`	Read HAL and platform documentation

Output Formats

--format pretty   # Indented JSON (default for TTY)
--format json     # Compact JSON for piping
--format table    # ASCII table for lists

SDK Install

Install the Herd TypeScript SDK to integrate Herd tools into your applications.

npm install @herd-labs/sdk

Authentication

Use an API key generated via the CLI (herd login) or set the HERD_API_KEY environment variable.

import { HerdSDK } from "@herd-labs/sdk";

const herd = new HerdSDK({
  apiKey: process.env.HERD_API_KEY,
});

The SDK provides programmatic access to all the same tools available through the MCP server and CLI.

Capabilities

Contracts

Fetch metadata, search source code, compare proxy implementations, inspect role topology

Transactions

Decode traces, parse logs, track balance changes

Wallets

Detect wallet types, view holdings, list deployments

HAL

Create and simulate actions, adapters, code blocks, and collections

Bookmarks

Save and manage wallets, contracts, and transactions

Supported Networks

Network	Status
Ethereum	Supported
Base	Supported

Tools Quick Reference

Contract Tools

Tool	Use For
Contract Metadata	Contract info, ABI, proxy history, token data
Code Analysis	Search contract source code with regex
Diff Versions	Compare implementation version upgrades
Role Topology	Inspect role/permission structure of a contract

Transaction Tools

Tool	Use For
Query Transaction	Decoded traces, logs, balances, transfers
Latest Transactions	Recent function/event calls with filters
Transaction Activity	Address tx history with filters

Wallet Tools

Tool	Use For
Wallet Overview	Wallet type, balances, tx count, signers
Token Activity	Token transfer history for a given position
Deployed Contracts	Contracts deployed by an address

Bookmark Tools

Tool	Use For
Bookmarks	List, add, edit, remove saved items

HAL Tools

Tool	Use For
Actions & Adapters	Create, search, update, delete HAL actions and adapters
Code Blocks	Create, update, execute TypeScript code blocks
Collections	Organize actions and adapters into collections
Evaluation	Simulate and test HAL expressions
Documentation	Read HAL and platform docs

​Herd Agent

​MCP Install

​Authenticate

​Manage

​CLI Install

​Authenticate

​Commands

​Output Formats

​SDK Install

​Authentication

​Capabilities

Contracts

Transactions

Wallets

HAL

Bookmarks

​Supported Networks

​Tools Quick Reference

​Contract Tools

​Transaction Tools

​Wallet Tools

​Bookmark Tools

​HAL Tools

Herd Agent

MCP Install

Authenticate

Manage

CLI Install

Authenticate

Commands

Output Formats

SDK Install

Authentication

Capabilities

Supported Networks

Tools Quick Reference

Contract Tools

Transaction Tools

Wallet Tools

Bookmark Tools

HAL Tools