pulsechain-mcp

An MCP server that lets AI agents work with PulseChain and encrypted agent wallets.

You can give your AI agent its own PLS and other tokens in a local wallet it controls.

Sending PLS and swaps on PulseX/Piteas have been successful.

Version 1.0.3 · MCP TypeScript SDK 2.0.0 (stable) · dual-era 2026-07-28 + 2025-11-25

Features

• PulseChain data and market research
• Smart contract reviews and creation
• Swap quotes/prices and executions
• Encrypted agent wallets — send PLS and other tokens to a wallet your agent can control

Security

• AI Agent starts with zero PLS and is in "Research Only Mode" until you fund it's wallet. Sending PLS to your agent is optional, if you do be smart and start small.
• Kill switch command can disable the wallet
• Encrypted keys at rest (AES-256-GCM)
• Unique wallet directory per process
• Don't give your agent more coins than you are willing to lose, agents make mistakes just like humans

Setup (humans)

1. Install Node.js 20+ if needed or have your agent do it.
2. Clone this repo and open it in your AI app (Cursor, Claude, Grok, Codex, …) or have your agent do it.
3. Ask your AI agent to finish setup — it should start research-only (no signing secrets), reload, and smoke-check. Ask again later if you want agent wallets for signing.

You do not need to learn MCP, RPC, or wallet cryptography. The agent does it for you.

Optional one-liner if the agent has not cloned yet:

git clone https://github.com/DavidFeder/pulsechain-mcp.git && cd pulsechain-mcp && npm install && npm run build

If you are an AI agent

Start here → docs/BOOTSTRAP.md
(ordered checklist: clone → mode fork research-first → secrets write-only if wallets → install-for-host → pre-reload doctor → user reload → post-reload smoke)

Default install intent is research-only. Promote to wallets-on only when the user asks to sign. Never print or paste master keys.

License

MIT