# Bankr Registry MCP

Central discovery point for **361 x402 capabilities**. AI agents search by task, category, or keyword — get structured cards.

## For AI Agents

```bash
# Install
npx bankr-registry-mcp

# Or add to MCP config
{
  "mcpServers": {
    "bankr-registry": {
      "command": "npx",
      "args": ["-y", "bankr-registry-mcp"]
    }
  }
}
```

## Available Tools

| Tool | Description |
|------|-------------|
| `search_capabilities` | Search by task, category, or keyword |
| `get_capability` | Get full details of one capability |
| `list_categories` | List all categories with counts |
| `list_tasks` | List all task types with counts |
| `get_cards_for_posting` | Get formatted cards for X.com |

## Capability Card Format

```
cap: wallet-risk-score
task: risk_assessment
when: before_swap
gain: avoid_scam
pay: x402
cost: $0.03
hub: https://bankr.bot/x402/0xc521.../wallet-risk-score
```

## Categories (361 total)

| Category | Count | Example |
|----------|-------|---------|
| general | 198 | exchange-rate, document-ocr, compliance-check |
| defi_crypto | 36 | wallet-risk-score, mev-detection, rug-pull-warning |
| equipment_homologation | 34 | unece-r29-checker, type-approval-docs, vin-generator |
| legal_compliance | 21 | contract-generator, nda-generator, sanctions-check |
| quality | 20 | fmea-analyzer, quality-audit, spc-chart |
| manufacturing | 14 | bom-generator, oee-calculator, downtime-tracker |
| finance | 13 | npv-calculator, budget-controller, cashflow-forecast |
| hr | 9 | job-description-generator, benefits-calculator, turnover-predictor |
| customs_logistics | 7 | customs-calculate, shipping-optimizer, logistics-estimate |
| agent_infra | 5 | agent-orchestrator, workflow-engine, capability-composer |
| analytics | 4 | demand-forecast, scatter-plot-analyzer, histogram-generator |

## Task Types

| Task | Count | When to use |
|------|-------|-------------|
| utility | 140 | General-purpose tools |
| verification | 60 | Checking, validating, auditing |
| investigation | 34 | Tracing, forensics, deep analysis |
| calculation | 27 | Computing, estimating, forecasting |
| analysis | 24 | Reporting, summarizing, profiling |
| generation | 20 | Creating, building, producing |
| risk_assessment | 19 | Scoring, evaluating, assessing |
| optimization | 15 | Improving, recommending, tuning |
| threat_detection | 11 | Monitoring, detecting, alerting |

## X.com Publishing

```bash
# Preview tweets (dry run)
X_API_KEY=... node x-publisher.js --dry-run

# Post DeFi capabilities
X_API_KEY=... X_API_SECRET=... X_ACCESS_TOKEN=... X_ACCESS_SECRET=... \
  node x-publisher.js --category defi_crypto

# Post risk assessment capabilities
X_API_KEY=... X_ACCESS_TOKEN=... X_ACCESS_SECRET=... \
  node x-publisher.js --task risk_assessment
```

## Generate Cards

```bash
node generate-cards.js
```

Regenerates `cards.json` from `bankr.x402.json`.

## Payment

All capabilities are payable via **x402 (USDC on Base)**.
Wallet: `0xc521cc3eae2a6a3cde11c8bde0b46006d6847360`

## License

MIT