# gibwork-mcp-proof-bridge

**MCP addon that brings verifiable proof-of-work to Gibwork agents.**

Exposes structured proof bundles, verification policies, and high-trust submissions as first-class agent capabilities.

Pairs with:
- [gibwork-proof-runner](https://github.com/mrphatom/gibwork-proof-runner)
- [gibwork-mcp-gateway](https://github.com/mrphatom/gibwork-mcp-gateway)
- Official `@gibwork/mcp`

## Quick Start

```bash
git clone https://github.com/mrphatom/gibwork-mcp-proof-bridge.git
cd gibwork-mcp-proof-bridge
npm install && npm run build

npx tsx src/cli.ts doctor
npx tsx src/cli.ts doctor --json
npx tsx src/cli.ts tools
npx tsx src/cli.ts skill

# Proxy to a local proof-runner
npx tsx src/cli.ts exec -- run --task <id> --dry-run
```

## Commands

| Command | Purpose |
|---------|--------|
| `doctor` | Locate proof-runner (`--json`) |
| `tools` | Emit MCP tool descriptors (JSON) |
| `skill` | Emit Claude Code / Codex skill fragment |
| `exec` | Proxy args to a local gibwork-proof-runner |

## Recommended MCP tools

- `proof_run` — execute verification policy
- `proof_inspect` — inspect proof bundle
- `proof_submit` — submit successful proof
- `policy_list` — list policies

## Integration

```
Agent → official MCP + proof-bridge → proof-runner → structured proof → Gibwork
Optional: gateway in front for policy + budgets + audit
```

Additive only — no hard renovation of existing Gibwork MCP required.

## License

MIT