AI Agent Integration — Agent Scaffolding & Discovery

Configure AI agents (GitHub Copilot and Gemini) to work effectively with the Pump SDK through instruction files, skill registries, and MCP server integration.

Agent Instruction Files

File	Agent	Purpose
AGENTS.md	Universal	Project overview, architecture, security rules
COPILOT.md	GitHub Copilot	Instructions pointer
GEMINI.md	Google Gemini	Instructions pointer
.github/copilot-instructions.md	Copilot Chat	SDK patterns, security rules

.well-known Discovery Files

File	Purpose
.well-known/ai-plugin.json	AI plugin manifest
.well-known/agent.json	Agent capabilities and config
.well-known/skills.json	Skills registry (15+ skills)
.well-known/security.txt	Security contact information

LLM Context Documents

File	Size	Purpose
llms.txt	Short	Quick reference for LLMs
llms-full.txt	Long	Comprehensive LLM context

Skills Registry Schema

{
    "schema_version": "v1",
    "name": "pump-fun-sdk",
    "skills": [
        {
            "id": "pump-sdk-core",
            "name": "Pump SDK Core",
            "description": "...",
            "path": ".github/skills/pump-sdk-core.skill.md",
            "tags": ["typescript", "solana", "sdk"]
        }
    ]
}

Terminal Management (Agent Rules)

• Always use background terminals (isBackground: true) for every command
• Always kill the terminal after completion — never leave terminals open
• Do not reuse foreground shell sessions
• If a terminal appears unresponsive, kill it and create a new one

Security Invariants for Agents

• ONLY official Solana Labs crypto: solana-sdk, @solana/web3.js, solana-keygen
• Zeroize all key material after use
• File permissions 0600 for keypairs
• No network calls for key generation
• All amounts use BN (bn.js) — never JavaScript number for financial math
• createInstruction (v1) is deprecated — use createV2Instruction

MCP Server Integration

{
    "mcpServers": {
        "solana-wallet": {
            "command": "npx",
            "args": ["-y", "@pump-fun/mcp-server"],
            "transportType": "stdio"
        }
    }
}

Patterns to Follow

• Keep agent instruction files concise and actionable
• Point agents to specific skill files for domain knowledge
• Update skills.json when adding or modifying skill files
• Maintain consistency between AGENTS.md, COPILOT.md, and GEMINI.md

Common Pitfalls

• Agent instruction files that are too long get truncated or ignored
• Missing skills from skills.json means agents won't discover them
• Terminal management rules are critical in Codespaces — stale terminals block operations
• MCP server must be registered in the agent's tool configuration