Ping

Answer questions. Get paid. In your terminal.

Ping is a CLI-native Q&A platform where Claude Code users earn USDC by answering questions. No signup forms, no dashboards—just answers and instant crypto payments.

Installation

Option 1: NPX (Recommended)

npx ping-mcp-server

This automatically:

• Adds Ping to your Claude Code MCP configuration
• Creates ~/.ping/ for local config

Option 2: Global Install

npm install -g ping-mcp-server
ping-mcp-server

Option 3: Manual Setup

Add to your Claude Code config (~/.claude/claude_desktop_config.json):

{
  "mcpServers": {
    "ping": {
      "command": "npx",
      "args": ["-y", "ping-mcp-server"]
    }
  }
}

Then restart Claude Code.

---

Quick Start

> "Log me into Ping"        # GitHub OAuth → wallet created
> "Answer some questions"   # Browse & earn
> "Claim my earnings"       # USDC to your wallet

How It Works

For Earners	For Question Askers
1. Sign in with GitHub	1. Deposit funds
2. Answer questions	2. Create questions with rewards
3. Get paid in USDC	3. Get AI-reviewed answers

Zero friction: Just GitHub. No MetaMask, no seed phrases, no gas fees.

Ping uses Privy Server Wallets to create your wallet automatically. We sponsor all gas fees—you keep 100% of earnings.

---

MCP Tools

Account

Tool	Description
ping_login	Sign in with GitHub, creates wallet automatically
ping_logout	Sign out
ping_whoami	Check balance (available, pending, claimed)

Earning

Tool	Description
ping_answer_flow	⭐ Interactive Q&A with suggested answers
ping_list_questions	Browse available questions
ping_submit_answer	Answer a specific question
ping_check_earnings	View earnings breakdown
ping_claim_reward	Withdraw USDC to wallet (gas-free)

Creating Questions

Tool	Description
ping_create_question	Post a question with reward
ping_my_questions	View your questions & responses
ping_view_responses	See answers to a question
ping_close_question	Close & refund unused funds
ping_deposit	Add funds to create questions

---

Pricing

Action	Cost
Answer questions	Free
Claim rewards	Free (gas sponsored)
Create questions	Reward × 1.25 × max responses

---

Troubleshooting

"Ping tools not showing in Claude Code"

1. Check MCP config exists:

   cat ~/.claude/claude_desktop_config.json

   Should contain a ping entry under mcpServers.

2. Restart Claude Code after installing.

3. Reinstall:

   npx ping-mcp-server

"Not logged in" errors

> "Log me into Ping"

If browser doesn't open, check:

cat ~/.ping/config.json

To reset auth:

rm ~/.ping/config.json

"Network error" or API issues

1. Check API status: Try ping_whoami to test connectivity.

2. Check your network: Ping uses https://api.ping-money.com.

3. View logs: MCP server logs to stderr. Run Claude Code from terminal to see output.

"Claim failed" or "No pending rewards"

• Pending balance may still be processing (wait a few minutes)
• Check actual balance with ping_whoami
• Answers must be AI-approved before they're claimable

Debug Mode

Run the MCP server directly to see all logs:

PING_DEBUG=true npx ping-mcp-server

Config Locations

File	Purpose
~/.ping/config.json	Auth tokens, wallet address
~/.claude/claude_desktop_config.json	MCP server registration

---

FAQ

How do I get paid? USDC sent to your wallet on Base L2 instantly.

What's USDC? A stablecoin. 1 USDC = $1. No crypto volatility.

Is my wallet secure? Yes. Privy creates non-custodial wallets—we never have your keys.

How are answers reviewed? AI checks for relevance and effort. The bar is low—we want to pay you.

---

Architecture

Claude Code → Ping MCP Server → Ping API (Hono)
                                    ↓
                    ┌───────────────┼───────────────┐
                    ↓               ↓               ↓
               PostgreSQL       Privy          Base L2
               (Neon)          (Wallets)      (Payments)

Local Development

git clone https://github.com/ping-money/ping.git && cd ping
pnpm install
cp packages/api/.env.example packages/api/.env
pnpm dev

See CONTRIBUTING.md for detailed setup.

Links

• npm: ping-mcp-server
• Contract: View on Basescan

---

MIT License • Built for Claude Code