Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@despread/3ridge-cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

3ridge CLI

Agent-native CLI for 3ridge campaign data. Read-only access to campaigns, leaderboards, rewards, and more.

Includes an MCP Server for AI agent integration (Claude, Codex, etc.).

Install

# Run without installing
npx -p @despread/3ridge-cli 3ridge campaigns list

# Or install globally
npm install -g @despread/3ridge-cli
3ridge campaigns list

Quick Start

# Check API health
3ridge health

# List visible campaigns
3ridge campaigns list --visible

# Campaign statistics
3ridge campaigns stats <campaign-id>

# Leaderboard top participants
3ridge leaderboard top <leaderboard-id> --limit 10

Commands

All commands are public and require no authentication.

Command	Description
`3ridge health`	API health check
`3ridge campaigns list [--visible]`	List campaigns
`3ridge campaigns get <id>`	Campaign details
`3ridge campaigns stats <id>`	Campaign statistics
`3ridge projects list`	List partner projects
`3ridge projects get <id>`	Project details
`3ridge quests list <campaign-id>`	List quests for a campaign
`3ridge rewards summary <campaign-id>`	Reward details
`3ridge leaderboard list`	List leaderboards
`3ridge leaderboard get <id>`	Leaderboard details
`3ridge leaderboard top <id> [--limit N]`	Top participants
`3ridge mindshare community`	Community mindshare data
`3ridge mindshare keywords`	Trending keywords
`3ridge oracle summary`	Market data (kimchi premium, stocks)

Output Formats

# JSON (default, agent-friendly)
3ridge campaigns list

# Table (human-readable)
3ridge --format table campaigns list

# CSV (spreadsheet export)
3ridge --format csv campaigns list > campaigns.csv

Global Options

--format <type>   json | csv | table (default: json)
--api-url <url>   Override API URL (e.g., staging)
--no-color        Disable colored output
--verbose         Debug logging

MCP Server

For AI agent integration (Claude Code, Codex, etc.):

Claude Code Setup

Add to .mcp.json in your project or ~/.claude/ directory:

{
  "mcpServers": {
    "3ridge": {
      "command": "npx",
      "args": ["-p", "@despread/3ridge-cli", "3ridge-mcp"]
    }
  }
}

Or with a local install:

{
  "mcpServers": {
    "3ridge": {
      "command": "node",
      "args": ["/path/to/3ridge-cli/dist/bin/3ridge-mcp.js"]
    }
  }
}

Available MCP Tools (13)

Tool	Description
`list_campaigns`	List campaigns with filters
`get_campaign`	Campaign details
`get_campaign_stats`	Aggregated statistics
`list_projects`	Partner projects
`get_project`	Project details
`list_quests`	Quests for a campaign
`get_rewards_summary`	Reward breakdown
`get_leaderboard_list`	All leaderboards
`get_leaderboard_top`	Top leaderboard entries
`get_mindshare`	Community mindshare
`get_trending_keywords`	Keyword trends
`get_oracle_summary`	Market data oracle
`check_health`	API health status

Example Agent Interaction

User: "3ridge 캠페인 3개의 이번 달 참여자 수 비교해줘"
Agent: [calls list_campaigns] -> [calls get_campaign_stats x3] -> comparison table

Security

Public endpoints only: no user data, no admin operations
Read-only: no write/update/delete operations
CSV output: formula injection prevention
URL params: encoded to prevent injection

License

MIT