§ integrations / anthropic

Anthropic Tool Use, with scope and audit attached.

Wrap Claude tool definitions with the live OC Agent delegation. Tool execution is gated by the active scope grammar pre-call; every tool result emits a signed agent-action envelope. Anchored to Bitcoin via the OC Stamp pipeline.

· shipping· published to npm · MIT· package @orangecheck/agent-anthropic@0.2.0

What it does

Claude's tool-use API exposes a list of tools and lets the model produce a sequence of tool_use blocks. The Fleet adapter intercepts those blocks at the boundary between Claude and your real tool implementation:

Validates the tool call against the agent's active OC Agent delegation. The exercised scope must be a sub-scope of a granted scope; if not, the call is refused before your handler runs.
Canonicalizes the (tool_name, input) tuple, BIP-322 signs it via the agent's wallet adapter, and emits an agent-action envelope (kind 30084) sharing OC Stamp's structure.
Returns the tool result to Claude alongside the envelope id, so the assistant's next turn carries provenance metadata if you choose to surface it.

Why this matters for compliance

Without the adapter, “the model called my tool” is the entire audit trail. With it, every tool execution carries: the agent address (BIP-322), the active delegation, the exercised scope, the content hash of the inputs, and the OC Stamp anchor — replayable offline forever.

Status

Adapter package: @orangecheck/agent-anthropic@0.2.0 is on npm. Source lives in oc-packages/agent-anthropic. MIT. Ships stampToolUse, postActionToFleet, and invokeWithStampAndPost — a thin wrapper over @orangecheck/agent-core + @orangecheck/agent-signer with the Claude-tool-use shape.

What Fleet adds on top: the managed signing pipeline, OC Stamp anchoring, Nostr publishing, audit-bundle assembly, and the operator dashboard. The package alone is enough to self-host; pair it with a Fleet project to remove ops.

preview · adapter shape

import Anthropic from '@anthropic-ai/sdk';
import { invokeWithStampAndPost } from '@orangecheck/agent-anthropic';

const anthropic = new Anthropic();

// stamp the tool_use, run the handler, and POST the receipt to fleet
// in one call. fleet re-derives the action id, validates scope, anchors
// to bitcoin via the OC Stamp pipeline, and republishes to Nostr.
const { result, action, posted } = await invokeWithStampAndPost({
  toolUse,                      // anthropic tool_use block
  handler: invoiceHandler,      // your real implementation
  signer,                       // bip-322 signer (UniSat / Xverse / paste)
  delegation,                   // active OC Agent delegation envelope
  fleet: {
    apiToken: process.env.OC_FLEET_TOKEN!,
    projectId: process.env.OC_FLEET_PROJECT_ID!,
  },
});

// posted = { id, project_id, delegation_id } once fleet accepts.
// omit `fleet` to stamp + execute without persistence — posted = null.

Already using the package?

Fleet adds the managed pipeline (OC Stamp anchoring, Nostr publishing, audit-bundle assembly, operator dashboard) on top of the open package. Design partners pair with an OrangeCheck engineer for the integration.

request access →read the docs →back to gallery →