Anchor Scaffold MCP turns an IDL — or a plain-English
description — into production-ready TypeScript clients, Rust
#[derive(Accounts)] structs, and full test suites for
Solana's Anchor framework. Runs as a Claude Code MCP server and a CLI.
#[derive(Accounts)] constraintsFour focused generators plus the infrastructure that makes them fast and cheap to run.
Typed instruction callers, PDA derivation helpers and account fetchers — generated straight from your IDL.
anchor-scaffold gen-ts-client
#[derive(Accounts)] structs with the right constraints and exact space calculations baked in.
anchor-scaffold gen-accounts
Mocha/Chai tests that exercise every instruction and assert on resulting account state.
anchor-scaffold gen-tests
Describe what you want in plain English and get a complete, idiomatic Anchor program back.
anchor-scaffold gen-program
Use it natively inside Claude Code as an MCP server, or run it as a standalone CLI in any pipeline.
claude · terminal
Point it at Claude, OpenAI, or any OpenAI-compatible endpoint. Your keys, your models, your control.
claude · openai · custom
Shared system context and IDL schemas are cached across calls, so repeated generations cost a fraction of a naive setup — without sacrificing quality.
~90% token cost reduction on repeat runs
One global install gives you the CLI and the MCP server binary.
$ npm install -g anchor-scaffold-mcpBring your own provider — Anthropic, OpenAI, or a compatible endpoint.
$ export ANTHROPIC_API_KEY=sk-ant-...
# or
$ export OPENAI_API_KEY=sk-...Feed it an IDL and pick a generator. Output lands in your project.
$ anchor-scaffold gen-ts-client \
--idl ./target/idl/escrow.json \
--out ./app/src/clientSame typed escrow client. One you maintain forever — the other regenerates from the IDL.
// You write all of this, then keep it in sync forever…
import { Program, BN, web3 } from "@coral-xyz/anchor";
function findEscrowPda(maker: web3.PublicKey, seed: BN) {
return web3.PublicKey.findProgramAddressSync(
[
Buffer.from("escrow"),
maker.toBuffer(),
seed.toArrayLike(Buffer, "le", 8),
],
PROGRAM_ID,
);
}
async function initialize(
program: Program,
maker: web3.PublicKey,
seed: BN,
amount: BN,
) {
const [escrow, bump] = findEscrowPda(maker, seed);
// remember the account order… and the constraints…
return program.methods
.initialize(seed, amount)
.accounts({ maker, escrow, /* …8 more */ })
.rpc();
}
// …repeat for every instruction. 😮💨$ anchor-scaffold gen-ts-client --idl target/idl/escrow.json
✓ Parsed IDL (4 instructions, 2 accounts)
✓ Generated typed instruction callers
✓ Generated PDA helpers + account fetchers
✓ Wrote app/src/client/escrow.ts (prompt cache hit · 91% cheaper)
// app/src/client/escrow.ts — now just import & call:
import { EscrowClient } from "./client/escrow";
const client = new EscrowClient(program);
await client.initialize({ maker, seed, amount }); // fully typed ✨
const escrow = await client.fetchEscrow(maker, seed);
const pda = client.pdas.escrow(maker, seed);Use the CLI in any project, or wire it into Claude Code as an MCP server.
Global install, then call any generator from your terminal or CI.
$ npm install -g anchor-scaffold-mcp
$ anchor-scaffold gen-ts-client \
--idl ./target/idl/myprog.jsonDrop this into your Claude Code MCP config and call the generators from chat.
{
"mcpServers": {
"anchor-scaffold": {
"command": "npx",
"args": ["-y", "anchor-scaffold-mcp"],
"env": {
"ANTHROPIC_API_KEY": "sk-ant-..."
}
}
}
}