Trendsurfer
MCP server for TrendSurfer β gives any AI agent trends.fun intelligence via Model Context Protocol
Ask AI about Trendsurfer
Powered by Claude Β· Grounded in docs
I know everything about Trendsurfer. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
TrendSurfer
The intelligence skill for trends.fun β graduation prediction, bonding curve analysis, creator wallet risk scoring, and trade execution via Meteora DBC for any AI agent.
Live Dashboard | Try the Sandbox | SDK Docs | npm Package
What is this?
trends.fun lets anyone tokenize a tweet on Solana. Tokens run on Meteora's Dynamic Bonding Curve. When enough buy pressure fills the curve, the token graduates β liquidity migrates to a DEX pool, price jumps.
TrendSurfer predicts which tokens will graduate, before it happens.
Not a bot. A reusable TypeScript SDK + MCP server that any AI agent can use.
Live Agent Stats
| Metric | Value |
|---|---|
| Tokens Scanned | 113,600+ |
| Unique Tokens | 865+ |
| Graduations Detected | 1,339+ |
| AI Predictions | 113,600+ |
| Agent Uptime | 24/7 on VM |
The SDK
npm install trendsurfer-skill
import { TrendSurferSkill } from 'trendsurfer-skill'
const skill = new TrendSurferSkill({ heliusApiKey: 'your-key' })
// Scan for new trends.fun launches
const { launches } = await skill.scanLaunches()
// One-shot analysis from just a mint address
const { graduation, security, token } = await skill.analyzeByMint(mint)
// β { score: 87, curveProgress: 72.3, velocity: 'accelerating', reasoning: '...' }
// Check security (honeypot, mint authority, freeze)
const security = await skill.checkSecurity(mint)
// Execute trade directly on Meteora DBC bonding curve
const trade = await skill.executeTrade({
tokenMint: mint,
side: 'buy',
amountSol: '0.1',
walletAddress: wallet,
signTransaction: signer,
})
The MCP Server
npx trendsurfer-mcp
Works with Claude Desktop, Cursor, or any MCP-compatible framework:
{
"mcpServers": {
"trendsurfer": {
"command": "npx",
"args": ["trendsurfer-mcp"]
}
}
}
8 tools: analyze_by_mint, scan_launches, analyze_graduation, check_security, get_quote, get_launches, refresh_launches, score_dev_wallet
Creator Wallet Risk Scoring (GoldRush)
TrendSurfer uses the GoldRush (Covalent) API to score token creators' wallets:
Token Creator Address β GoldRush API β Risk Profile
- Wallet age (days)
- Token holdings (portfolio diversity)
- Portfolio value (USD)
- Transaction count (activity level)
β Risk Score 0-100 (low / medium / high)
β Flags: "New wallet", "Low activity", etc.
Available via SDK, MCP (score_dev_wallet tool), and the dashboard sandbox.
The x402 API
GET /api/intelligence?mint=<address>
β 402 Payment Required
β Pay $0.001 USDC β get analysis
Native agent-to-agent micropayments via x402 protocol on Solana.
How Scoring Works
Every token gets a 0-100 graduation score based on:
| Signal | Weight | Source |
|---|---|---|
| Curve Progress | 25% | On-chain Meteora DBC pool state |
| Fill Velocity | 30% | Time-series bonding curve snapshots |
| Security Audit | 20% | On-chain analysis (honeypot, authorities) |
| Social Signal | 15% | Holder count x curve momentum (tweet virality proxy) |
| Holder Distribution | 10% | getTokenLargestAccounts RPC |
AI (Gemini Flash via CommonStack) blends signals with tweet content analysis for natural language reasoning.
Creator wallet risk via GoldRush provides an additional trust layer.
Architecture
ββββββββββββββββββββββββββββββββββββββββββββββββββ
β TRENDSURFER SKILL β
β (npm package + MCP server) β
β β
β scanLaunches() analyzeByMint() β
β analyzeGraduation() checkSecurity() β
β getQuote() executeTrade() β
β scoreDevWallet() (via GoldRush) β
ββββββββββββ¬βββββββββββββββββββββββ¬βββββββββββββββ
β β
βββββββββΌβββββββββ βββββββββΌβββββββββ
β OUR AGENT β β YOUR AGENT β
β 24/7 on VM β β npm install β
β Scan β Score β β or MCP/x402 β
β β Trade β β β
βββββββββ¬βββββββββ ββββββββββββββββββ
β
βββββββββΌβββββββββ
β DASHBOARD β
β Live feed β
β Predictions β
β Graduations β
β Creator Risk β
β Agent logs β
ββββββββββββββββββ
The Dashboard
- Interactive Sandbox β Paste any mint, auto-analyzes trending tokens on first visit
- Creator Wallet Risk β GoldRush-powered wallet age, portfolio, activity scoring
- Agent Live Decisions β See what the agent is watching in real-time
- Graduation Tracker β Verified graduations with prediction accuracy
- Live Scanner β Token feed with bonding curve progress bars
- AI Reasoning β Full CommonStack AI analysis for every prediction
- Tweet Analysis β Social signal scoring for tokenized tweets
Quick Start
git clone https://github.com/shariqazeem/trendsurfer.git
cd trendsurfer
npm install
# Set up env vars
cp .env.example .env.local
# Add: HELIUS_API_KEY, COMMONSTACK_API_KEY, GOLDRUSH_API_KEY
# Run dashboard
npm run dev
# Run agent (paper mode without wallet)
npm run agent
# Run MCP server
npm run mcp
Tech Stack
| Layer | Technology |
|---|---|
| Skill SDK | TypeScript, npm package |
| MCP Server | @modelcontextprotocol/sdk (8 tools) |
| AI Analysis | CommonStack API (Gemini Flash) |
| Wallet Risk | GoldRush / Covalent API |
| Trading | Meteora DBC (direct on-chain) |
| On-Chain | Helius RPC, Meteora DBC program |
| Dashboard | Next.js 14, Tailwind CSS, Framer Motion |
| Database | SQLite (better-sqlite3) |
| Payments | x402 protocol (USDC micropayments) |
Built For
Solana Agent Economy Hackathon: Agent Talent Show (March-April 2026)
Built by @shariqshkt
Built with Solana, Meteora DBC, trends.fun, Helius, CommonStack AI, GoldRush (Covalent), x402, MCP
