Skip to main content
Glama

License: MIT TypeScript Model Context Protocol Solana

Gibwork Sentinel is a developer automation utility, interactive terminal tool, and native Model Context Protocol (MCP) Server designed to bridge the Gibwork Solana Bounty Protocol (gib.work) with autonomous AI agents (Claude, Cursor, Antigravity, OpenCode) and terminal power users.

It eliminates the friction of web-app browsing by providing automated bounty discovery, on-chain Solana escrow verification, and automated project workspace scaffolding.


šŸš€ Key Features

  • ⚔ Fast Terminal CLI (gib-sentinel): Real-time filtering across active Gibwork bounties by payout amount (USDC/SOL), category, and status.

  • šŸ¤– Native Model Context Protocol (MCP) Server: Enables LLM agents to autonomously discover tasks, read deliverable specifications, and verify escrow parameters via standard MCP tools.

  • šŸ”’ On-Chain Solana Escrow Verification: Directly queries Solana Mainnet JSON-RPC to verify that advertised bounty token mints (e.g. SPL USDC EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v) exist and are valid before committing development hours.

  • šŸ“ Automated Workspace Scaffolding: Automatically creates an isolated project directory with task metadata, deliverable checklists (DELIVERABLE_SPEC.md), and PR templates for any claimed bounty.


Related MCP server: Escrow Sentinel

šŸ“¦ Installation & Setup

Prerequisites

  • Node.js >= 18.0.0

  • npm or pnpm

Global Installation (or Run with npx)

git clone https://github.com/TomerGamerTV/gibwork-sentinel.git
cd gibwork-sentinel
npm install
npm run build
npm link

šŸ› ļø CLI Usage Guide

1. List Open Bounties

Discover all open bounties funded on Solana:

gib-sentinel list

Filter by minimum reward amount and token:

# Bounties paying >= 100 USDC
gib-sentinel list --min 100 --token USDC

# Filter by category
gib-sentinel list --category Development

Output as machine-readable JSON:

gib-sentinel list --json

2. Inspect Bounty Requirements

Fetch full requirements, deadline, and creator metadata:

gib-sentinel inspect 1052f22d-3f87-4b1d-b0d7-71a60679e7fa

3. Verify On-Chain Solana Escrow

Cross-validate the token mint and escrow contract parameters on Solana Mainnet:

gib-sentinel verify 1052f22d-3f87-4b1d-b0d7-71a60679e7fa

Sample output:

Verifying on-chain parameters for task 1052f22d-3f87-4b1d-b0d7-71a60679e7fa...

--- Solana Escrow & Mint Verification ---
Network:      Solana Mainnet-Beta
Token Mint:   EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
Token Symbol: USDC
Status:       VERIFIED_ON_CHAIN
Notes:        Canonical USDC (USD Coin)
-----------------------------------------

4. Scaffold Development Workspace

Automatically scaffold an isolated deliverable environment:

gib-sentinel scaffold 1052f22d-3f87-4b1d-b0d7-71a60679e7fa

Creates:

bounty_workspaces/gibwork-developer-hackathon-bounty-1052f22d/
ā”œā”€ā”€ task_metadata.json
ā”œā”€ā”€ DELIVERABLE_SPEC.md
└── PULL_REQUEST_TEMPLATE.md

šŸ¤– Model Context Protocol (MCP) Integration

Gibwork Sentinel exposes 4 native MCP tools for autonomous AI agents:

Tool Name

Description

Arguments

gibwork_list_bounties

List and filter active bounties from Gibwork

minAmount, token, category, search

gibwork_get_bounty_details

Get complete description and requirements

taskId (UUID)

gibwork_verify_escrow

Verify on-chain Solana mint & escrow parameters

taskId (UUID)

gibwork_scaffold_workspace

Scaffold local development directory

taskId (UUID), outputDir

Configuration for Claude Desktop / Cursor / Antigravity

Add the following to your MCP settings configuration:

{
  "mcpServers": {
    "gibwork-sentinel": {
      "command": "node",
      "args": ["/path/to/gibwork-sentinel/dist/mcp-server.js"]
    }
  }
}

šŸ›ļø Architecture & Data Flow

+---------------------+        +-------------------------+
|   Terminal User     |        |   Autonomous AI Agent   |
|   (gib-sentinel)    |        |   (Claude / Cursor MCP) |
+----------+----------+        +------------+------------+
           |                                |
           +---------------+----------------+
                           |
                           v
              +--------------------------+
              |    Gibwork Sentinel      |
              |    Core Engine           |
              +-------------+------------+
                            |
            +---------------+---------------+
            |                               |
            v                               v
+-----------------------+       +------------------------+
|  Gibwork Explore API  |       |   Solana Mainnet RPC   |
|  (api.gib.work)       |       |   (Token Mint Verify)  |
+-----------------------+       +------------------------+

šŸ“„ License

MIT License. Authored by Tomer (@TomerGamerTV).

Available Tools

4 tools
gibwork_get_bounty_detailsA

Get full description, requirements, creator info, and deadline for a specific Gibwork bounty ID.

Inputs: taskId (required).

gibwork_list_bountiesA

Discover and filter live bounties on the Solana Gibwork decentralized marketplace.

Inputs: token, search, category, minAmount.

gibwork_scaffold_workspaceA

Scaffold a local development directory with PR template, checklist, and metadata for a Gibwork bounty.

Inputs: taskId (required), outputDir.

gibwork_verify_escrowA

Verify the on-chain Solana token mint and escrow parameters for a Gibwork bounty before starting work.

Inputs: taskId (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool targets a distinct stage of the bounty workflow: discovery, detail lookup, escrow verification, and workspace setup. There is no meaningful overlap between list, get, verify, or scaffold.

    Naming Consistency5/5

    All tool names follow the same gibwork_<verb>_<noun> convention: list_bounties, get_bounty_details, verify_escrow, scaffold_workspace. The pattern is uniform and predictable.

    Tool Count5/5

    Four tools is a tight, well-scoped set for the server's apparent purpose of safely discovering and preparing for Gibwork bounties. Each tool serves a necessary function without redundancy.

    Completeness4/5

    The toolset covers the full pre-work lifecycle: find bounties, inspect details, verify escrow, and scaffold a workspace. Post-submission actions like submitting or claiming work are absent, but they appear outside the server's stated scope as a pre-work sentinel.

    Maintenance

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      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.
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables developers and AI agents to discover, rank, watch, and draft submissions for Gibwork coding bounties through MCP tools, with optional wallet-authenticated SDK support.
      1
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables agents to scout open Gibwork bounties, plan subtask crews, preview escrow funding, and inspect subtask status and ledgers without spending money. Read-only tooling keeps all actual escrow funding and fee payment in the CLI under explicit approval.
      MIT