Content
# 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.12`** · 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:
```bash
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](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
MCP Store