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.13 · 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 24.22.1 (Active LTS) or a newer build on a supported line — 22.23.4, 24.22.1, or 26.12.1 — or have your agent do it. These are the 21 October 2026 security releases. Node.js 20 is end of life and did not receive them.
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.

Questions for an agent

• pHEX: “Which of my pHEX stakes end in the next 30 days?” hex_stake_summary is a read-only estimate, not an endStake payout or financial advice.
• Buy and burn: “Is PulseX buy and burn running, and how much PLSX is in the dead address?” pulsex_buy_and_burn is a contract read, not financial advice.
• Pump.tires: “Is this Pump.tires coin still on the curve, or has it graduated?” pump_tires_coin is read-only, meme, not financial advice.

License

MIT