gibwork-bounty-hunter
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@gibwork-bounty-hunterrank 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
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 |
| explore / rank / show / draft / apply-pack / overnight-report / rails-scout / grind-report / watch / alert / doctor |
MCP server | tools for Cursor / Claude / other agents |
| 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: gibwork-mcp-server
Requirements
Node.js ≥ 22
Optional: Solana keypair file for authenticated SDK calls (
GIBWORK_PRIVATE_KEYorGIBWORK_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 PATHCopy .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 notesAfter npm run build:
node dist/cli/index.js rank --top 5 --tableMCP 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 |
| List open bounties |
| Rank coding/dev bounties (includes score breakdown) |
| Fetch one bounty by UUID |
| Markdown submission draft (no payment) |
| Apply/submission pack (outline + checklist; UUID or slug) |
| Overnight coding bounty snapshot + skill-match scores |
| Superteam Earn + Frantic + DeskCrew ≥minUsd agent/coding scout |
| Wallet + rails-scout + Collaborators overnight one-pager (no Phantom) |
| One-shot poll for newly appearing ≥minUsd bounties |
| 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/mcpPublic REST fallback:
https://api.gib.work/exploreandhttps://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.createwith a persisted idempotency keyDoes 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
Related MCP Connectors
AI-native git hosting — repos, PRs, issues, CI gates, and AI code review over MCP (60 tools).
Pay-per-use tool marketplace for AI agents. Search, price-check, and call APIs via MCP.
Search GitHub, npm, PyPI, StackOverflow, ArXiv from one MCP — built for coding agents.
Discover verified deep-tech engineering bounties from any AI agent.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI agents to find and query real-time GitHub coding bounties with built-in scam filtering, supporting listing, matching, and detailed bounty retrieval.448 npmApache 2.0
- FlicenseNot gradedqualityCmaintenanceEnables AI assistants to search, retrieve, create, triage codebases, scaffold solutions, and validate deliverables for Gibwork bounties on Solana.-
- AlicenseNot gradedqualityAmaintenanceEnables 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.MIT
- AlicenseNot gradedqualityBmaintenanceEnables MCP-compatible AI clients and coding agents to turn vague GitHub requests into structured, testable task contracts, inspect repository evidence, simulate execution, validate readiness, and preview or publish Gibwork bounties only after explicit confirmation.MIT