# Pump Fun

> pump-fun

- Skill: `nirholas/pump-fun` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add nirholas/pump-fun`
- Raw SKILL.md: https://api.skillmd.com/api/skills/nirholas/pump-fun/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: nirholas (https://skillmd.com/u/nirholas)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/nirholas/pump-fun

---

# pump-fun

Read-only Solana market intel for three.ws agents. The skill calls the
in-house MCP route at `/api/pump-fun-mcp` (not an external host), so it
works on any deployment of three.ws without third-party DNS or proxies.

## Tools (10)

| Tool | Backed by | Notes |
|---|---|---|
| `getBondingCurve` | `@pump-fun/pump-sdk` on-chain | Real reserves + graduation %. Always available. |
| `getTokenDetails` | Solana RPC + Metaplex metadata | Mint, supply, decimals, name, symbol. Always available. |
| `getTokenHolders` | `connection.getTokenLargestAccounts` | Top holders + concentration. Always available. |
| `searchTokens` | upstream pumpfun-claims-bot | Requires `PUMPFUN_BOT_URL`. |
| `getTokenTrades` | upstream pumpfun-claims-bot | Requires `PUMPFUN_BOT_URL`. |
| `getTrendingTokens` | upstream pumpfun-claims-bot | Requires `PUMPFUN_BOT_URL`. |
| `getNewTokens` | upstream pumpfun-claims-bot | Requires `PUMPFUN_BOT_URL`. |
| `getGraduatedTokens` | upstream pumpfun-claims-bot | Requires `PUMPFUN_BOT_URL`. |
| `getKingOfTheHill` | upstream pumpfun-claims-bot | Requires `PUMPFUN_BOT_URL`. |
| `getCreatorProfile` | upstream pumpfun-claims-bot | Requires `PUMPFUN_BOT_URL`. |

Tools requiring the indexer return JSON-RPC error `-32004` (with a clear
configuration message) when the bot URL is not set — they never return
fabricated or placeholder data.

## Endpoint resolution

The skill resolves `/api/pump-fun-mcp` against the page origin
(`window.location.origin`) at call time. No build-step configuration needed.

## Install

Reference the bundle from your agent manifest:

```json
{
  "skills": [
    { "uri": "skills/pump-fun/" }
  ]
}
```

## Sentiment hooks

Some handlers attach a `sentiment` (-1..1) to their result so the avatar's
Empathy Layer reacts:

- `getCreatorProfile` with rug flags → negative (concern)
- `getBondingCurve` near graduation → positive (celebration)
- `getTokenHolders` with whale concentration → negative (concern)
- `getKingOfTheHill` → mild positive (curiosity)

## Suggested system prompt

> When the user mentions a token name, symbol, or mint address, call
> `searchTokens` first, then `getBondingCurve` and `getTokenHolders`
> before giving an opinion. Always check `getCreatorProfile` for rug
> flags before recommending a buy.