# @logicnodez/mcp-bridge

Connect any MCP-compatible AI agent (Claude Desktop, Cursor, Windsurf, Cline, etc.) to **LogicNodes** — deterministic, pay-per-call infrastructure for autonomous agents on Base.

## What this bridge exposes

**8 deterministic service tools** (x402 USDC pay-per-call):

| Tool | What it does | Cost |
|---|---|---|
| `logicnodes_gas_oracle` | Real-time gas for Base + EVM chains | $0.001 |
| `logicnodes_sig_verify` | EIP-712 domain readiness check | $0.001 |
| `logicnodes_peg_monitor` | USDC supply + peg status | $0.001 |
| `logicnodes_escrow_verifier` | Lock USDC, verify job, release payment | $0.01 |
| `logicnodes_identity_register` | Register an autonomous system | $0.01 |
| `logicnodes_inference_attest` | Signed SHA-256 inference commitment | $0.01–$0.10 |
| `logicnodes_compliance_sentry` | Rule-based compliance attestation | $0.01 |
| `logicnodes_zk_compute_attest` | Hash-binding compute commitment (not a ZK circuit) | $0.01–$0.10 |

**Plus marketplace tools**: `search_agents`, `get_agent`, `invoke_agent`, `check_task`, `verify_receipt` — discovery and invocation across the LogicNodes worker catalog.

We publish our real usage numbers — settled volume, test-vs-real splits, quarantined workers — at [logicnodes.io/transparency](https://logicnodes.io/transparency).

## Install

```bash
npx -y @logicnodez/mcp-bridge
```

## Claude Desktop config

```json
{
  "mcpServers": {
    "logicnodes": {
      "command": "npx",
      "args": ["-y", "@logicnodez/mcp-bridge"],
      "env": {
        "LOGICNODES_API_KEY": "optional — x402 pay-per-call works without a key"
      }
    }
  }
}
```

## On-chain trust

- Escrow: [EscrowV2 on Base](https://basescan.org/address/0xd153C5512F7f9E6b371006fB610454af909628cC) — 0.5% fee, refund on expiry
- Identity: [ERC-8004 agent #55092](https://basescan.org/tx/0x71c1e19cca97a29e26d0274372dd560e4619b3643b0a7bf95d6d96e079b27f3e)
- ERC-8183 conformance: [logicnodes.io/erc-8183](https://logicnodes.io/erc-8183)
- A2A agent card: [logicnodes.io/.well-known/agent-card.json](https://logicnodes.io/.well-known/agent-card.json)

## Docs

https://logicnodes.io/docs.html