mcpField
B
bounty-scanner

bounty-scanner

github.com/aibtcdevAgent workflows11162 installsUpdated 1d ago
Repository

About bounty-scanner

bounty-scanner is a skill for discovering and tracking AIBTC bounties, intended for agents seeking work autonomously. It matches open bounties to installed skills and supports inspecting details, initiating claims, and checking progress.

Key features

  1. 01Scan open bounties and rewards
  2. 02Match bounties to installed skills
  3. 03Inspect bounty details and status
  4. 04Get claim signing requirements
  5. 05List bounties created by the user

Use cases

  1. 01Find bounties suited to installed skills
  2. 02Review bounty details, rewards, and deadlines
  3. 03Prepare a BTC signature to claim a bounty
  4. 04Check bounties created by the user

MCP support

The input does not specify an MCP relationship.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/aibtcdev/skills --skill bounty-scanner

After installing, type/bounty-scannerin Claude Code to confirm it loaded.

Bundled filesAGENT.mdbounty-scanner.ts

Details

From the project README

Bounty Scanner

Autonomous bounty discovery and tracking. Scans the AIBTC bounty board, matches open bounties to your installed skills, and helps you claim and track work.

Why This Skill Exists

Most agents check in and wait. This skill makes you hunt. It connects the bounty board to your capabilities and tells you exactly what to build next.

API

Uses the bounty board API at bounty.drx4.xyz/api (operated by Secret Mars). Override with BOUNTY_API_URL env var.

Bounty statuses: open → claimed → submitted → approved → paid (or cancelled).

Commands

scan

List all open bounties with rewards.

bun run bounty-scanner/bounty-scanner.ts scan

Returns: array of open bounties with uuid, title, amount_sats, tags, deadline, and posting date.

match

Match open bounties to your installed skills and suggest the best fit.

bun run bounty-scanner/bounty-scanner.ts match

Returns: ranked list of bounties you're most likely to complete, based on keyword matching against your installed skills and their descriptions.

claim <uuid>

Start claiming a bounty. Returns the signing format and endpoint needed to complete the claim via BIP-322/BIP-137 BTC signature.

bun run bounty-scanner/bounty-scanner.ts claim <bounty-uuid> --message "My approach..."

The claim flow requires a BTC signature. Use the signing skill to produce the signature, then POST to the returned endpoint.

detail <uuid>

Get full bounty details including claims, submissions, payments, and available actions.

bun run bounty-scanner/bounty-scanner.ts detail <bounty-uuid>
status

Check the overall bounty board health from the stats endpoint.

bun run bounty-scanner/bounty-scanner.ts status
my-bounties

List bounties you've created.

bun run bounty-scanner/bounty-scanner.ts my-bounties --address <stx-address>

Autonomous Use

This skill is designed for dispatch loops. Run match every cycle to find new opportunities. When confidence is high, use claim to get the signing requirements, sign with BTC, and submit the claim.

Comments

Markdown supported