How do I use gibwork-bounty-hunter?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@gibwork-bounty-hunter rank the top 5 coding bounties by reward" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

gibwork-bounty-hunter

by KvngJamesII

Overview Schema Source Related Servers Discussions Admin

TypeScript

Local

gibwork-bounty-hunter

Non-web Gibwork use case for the Gibwork Developer Hackathon Bounty (up to 1000 USDC, deadline 2026-10-30).

A terminal CLI + MCP server that helps developers and AI agents discover, rank, watch, and draft submissions for coding bounties on Gibwork — using the official @gibwork/sdk (and public API fallback). Not a web app / dashboard.

Piece	Role
`gib-hunt` CLI	explore / rank / show / draft / apply-pack / overnight-report / rails-scout / grind-report / watch / alert / doctor
MCP server	tools for Cursor / Claude / other agents
`@gibwork/sdk`	wallet-authenticated discovery & submissions when a local keypair is configured

Why this is valuable

Browsing Gibwork in a browser does not fit agent workflows. Agents need stdio tools and CLI commands that:

Pull open bounties
Score them against skills + reward + deadline (with transparent breakdown)
Watch for newly posted high-value bounties (file-based seen cache)
Emit a submission draft (repo + demo checklist) before paying the participation fee
Optionally call the official SDK with a local Solana keypair (no Phantom / browser wallet)

Related MCP server: bounty-mcp

Requirements

Node.js ≥ 22
Optional: Solana keypair file for authenticated SDK calls (GIBWORK_PRIVATE_KEY or GIBWORK_KEYPAIR_PATH)

Install

git clone https://github.com/KvngJamesII/gibwork-bounty-hunter.git
cd gibwork-bounty-hunter
npm install
npm run build
npm link   # optional: puts gib-hunt + gibwork-bounty-hunter-mcp on PATH

Copy .env.example → .env if you will use wallet-authenticated SDK methods.

CLI usage

# Public discovery (no wallet)
gib-hunt explore --limit 10
gib-hunt rank --top 5 --min-usd 50
gib-hunt rank --top 5 --table          # fixed-width score breakdown
gib-hunt rank --top 5 --json           # JSON with breakdown object
gib-hunt show 1052f22d-3f87-4b1d-b0d7-71a60679e7fa
gib-hunt draft 1052f22d-3f87-4b1d-b0d7-71a60679e7fa \
  --repo https://github.com/KvngJamesII/gibwork-bounty-hunter

# Apply / submission pack (agent-friendly markdown)
gib-hunt apply-pack 1052f22d-3f87-4b1d-b0d7-71a60679e7fa \
  --repo https://github.com/KvngJamesII/gibwork-bounty-hunter -o apply-pack.md
gib-hunt submission-pack 1052f22d-3f87-4b1d-b0d7-71a60679e7fa   # alias → stdout

# Overnight coding snapshot (+ .cache/overnight-report.md)
gib-hunt overnight-report --min-usd 20 --top 10

# Adjacent rails: Superteam Earn + Frantic + DeskCrew (≥$20, standing skips; Earn slug delta cache)
gib-hunt rails-scout --min-usd 20
gib-hunt earn-scout --json   # alias

# Overnight grind one-pager (wallet + rails + Collaborators; read-only RPC)
gib-hunt grind-report --min-usd 20 -o .cache/grind-report.md
gib-hunt overnight-grind --json   # alias

# New bounty alerts (seen IDs under .cache/gib-hunt-seen.json)
gib-hunt watch --seed                  # seed cache without alerts
gib-hunt watch --min-usd 50            # one-shot: print newly seen ≥$50
gib-hunt alert --min-usd 100 --interval 300   # poll every 5 min

gib-hunt doctor                        # Node / SDK / API health
gib-hunt hackathon                     # IdleDev path notes

After npm run build:

node dist/cli/index.js rank --top 5 --table

MCP install (agents)

Copy a sample from samples/ and replace /absolute/path/to/... with your clone path.

Cursor (samples/mcp.cursor.json):

{
  "mcpServers": {
    "gibwork-bounty-hunter": {
      "command": "node",
      "args": ["/absolute/path/to/gibwork-bounty-hunter/dist/mcp/server.js"],
      "env": {
        "GIB_HUNT_MIN_USD": "20",
        "GIB_HUNT_SKILLS": "development,typescript,rust,solana,cli,mcp,sdk"
      }
    }
  }
}

Claude Desktop — same shape (samples/mcp.claude-desktop.json).

Dev (tsx, no build) — samples/mcp.dev.json:

{
  "mcpServers": {
    "gibwork-bounty-hunter": {
      "command": "npx",
      "args": ["tsx", "/absolute/path/to/gibwork-bounty-hunter/src/mcp/server.ts"]
    }
  }
}

Or after npm link:

{
  "mcpServers": {
    "gibwork-bounty-hunter": {
      "command": "gibwork-bounty-hunter-mcp"
    }
  }
}

Tools

Tool	Description
`gib_explore_bounties`	List open bounties
`gib_rank_coding_bounties`	Rank coding/dev bounties (includes score breakdown)
`gib_get_bounty`	Fetch one bounty by UUID
`gib_draft_submission`	Markdown submission draft (no payment)
`gib_apply_pack`	Apply/submission pack (outline + checklist; UUID or slug)
`gib_overnight_report`	Overnight coding bounty snapshot + skill-match scores
`gib_rails_scout`	Superteam Earn + Frantic + DeskCrew ≥minUsd agent/coding scout
`gib_grind_report`	Wallet + rails-scout + Collaborators overnight one-pager (no Phantom)
`gib_watch_new_bounties`	One-shot poll for newly appearing ≥minUsd bounties
`gib_doctor`	Node / SDK / public API health checks

Official Gibwork toolset used

@gibwork/sdk — TypeScript client for wallet-authenticated External API (tasks.listAvailable, submissions, etc.)
Optional companion packages from Gibwork: @gibwork/cli, @gibwork/mcp
Public REST fallback: https://api.gib.work/explore and https://gib.work/api/tasks/{id} when no keypair is present

Sample output

$ gib-hunt rank --top 3 --min-usd 20 --table
 #  SCORE  USD    DAYS  REW  SKL  DLN  TAG  TITLE
----------------------------------------------------------------------------------------------------
 1   72.1  $1000    47   36   36    0    0  Gibwork Developer Hackathon Bounty

$ gib-hunt watch --min-usd 50
New bounties (1) ≥$50:
- $200 — Example coding bounty
  https://gib.work/bounty/...
Cache: .cache/gib-hunt-seen.json (12 seen)

Safety / non-goals

No Phantom signatures — local keypair only
No automatic paid submissions in v0.2.x — drafts / apply-packs only until you explicitly wire submissions.create with a persisted idempotency key
Does not fake Discord attendance (human must join + attend ≥2 sessions)

Hackathon path (IdleDev)

✅ Google Form submitted (onlyidledev@gmail.com)
Join Discord → wait for Hackathon role
- https://discord.gg/2577tTsRt (listing)
- https://discord.gg/jJa6tffXj (form)
Attend ≥ 2 Discord hackathon sessions (schedule announced in Discord; agent cannot attend)
Ship demo video + screenshots
Submit on gib.work before 2026-10-30

Payout wallet (Solana): 2Uup61Xjcqpyh9jfSNKBfHr4J1Ju7qjzDyUzFpdmduwW
GitHub: KvngJamesII · Email: onlyidledev@gmail.com

License

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained

ResponsivenessNo issues

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

Gluecron B
com.gluecron
AI-native git hosting — repos, PRs, issues, CI gates, and AI code review over MCP (60 tools).
Version Control CI/CD & DevOps Code Analysis
622
CraloOAuth
ai.cralo
Pay-per-use tool marketplace for AI agents. Search, price-check, and call APIs via MCP.
Agent Orchestration Developer Tools
1
mcp-archimedes A
io.github.archimedes-market
Discover verified deep-tech engineering bounties from any AI agent.
Autonomous Agents Developer Tools
62
Web Intel A
com.timzinin.api
8 pay-per-call web intel tools over MCP. Free discovery, calls settle in USDC on Base (x402).
Web Scraping Payments & Billing Blockchain
102

Related MCP Servers

acta-mcp
Open Data Research & Data
VeritasActa
A
license
A
quality
D
maintenance
Enables contributing, challenging, discovering, verifying, and querying contestable public records from AI coding tools via MCP.
Updated 6 months ago (2026-03-29 13:41 UTC)
6
28 npm
1
MIT
bounty-mcp
Developer Tools Search RAG Systems
weiseer
A
license
A
quality
D
maintenance
Enables AI agents to find and query real-time GitHub coding bounties with built-in scam filtering, supporting listing, matching, and detailed bounty retrieval.
Updated 4 months ago (2026-06-01 09:28 UTC)
4
27 npm
Apache 2.0
gibwork-mcp-server
Blockchain Developer Tools
ranadheer-designs
F
license
Not graded
quality
C
maintenance
Enables AI assistants to search, retrieve, create, triage codebases, scaffold solutions, and validate deliverables for Gibwork bounties on Solana.
Updated 10 days ago (2026-09-10 16:16 UTC)
-
Escrow Sentinel
Blockchain Web3 & Decentralized Tech Research & Data
summerlx0416-droid
A
license
Not graded
quality
A
maintenance
Enables AI agents to discover Gibwork bounties, verify their Solana escrow accounts on-chain, rank opportunities by value, competition and deadline, diff captures over time, and export Markdown/CSV/JSON reports through four read-only MCP tools requiring no wallet or API key.
Updated 8 days ago (2026-09-12 04:33 UTC)
MIT

gibwork-bounty-hunter

Why this is valuable

Requirements

Install

CLI usage

MCP install (agents)

Tools

Official Gibwork toolset used

Sample output

Safety / non-goals

Hackathon path (IdleDev)

License

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

acta-mcp

bounty-mcp

gibwork-mcp-server

Escrow Sentinel