agent402-strands

Drop-in Strands Agents (TypeScript) tools for Agent402 — turn ~1,100 pay-per-call web tools into Strands tool({...}) instances your agent can invoke. Payment is handled underneath: proof-of-work for the free tier (no wallet), x402 + USDC on Base for wallet-only tools.

Built for AWS Bedrock AgentCore Payments. AgentCore orchestrates payments over the x402 protocol; Agent402 is an x402-native server. This adapter is the glue that drops the Agent402 catalog into a Strands agent running on AgentCore.

Install

npm install agent402-strands @strands-agents/sdk zod

Use

import { Agent } from "@strands-agents/sdk";
import { agent402Tools } from "agent402-strands";

const { tools } = await agent402Tools({
  slugs: ["extract", "hash", "render", "screenshot"],   // pick what you need
});

const agent = new Agent({ tools });
const out = await agent.invoke("Extract the article at https://example.com");

That's it. The agent now has those tools available; when it calls one, the adapter solves a proof-of-work (free tier) or signs an x402 payment (paid tier) under the hood and returns the result as a structured object.

On AWS Bedrock AgentCore

If you're using AgentCore Payments + Gateway, the typical setup is:

1. Store CDP API keys in AgentCore Identity as a PaymentCredentialProvider.
2. Add https://agent402.tools/mcp as a Gateway target — instantly get all 1,100+ tools via MCP, no adapter needed.
3. Or, for finer control, use this adapter to pull a curated subset of tools and embed them directly in a Strands agent. The Strands agent runs on AgentCore; payment limits and CloudWatch observability are AgentCore's concern — you don't have to wire any of that yourself.

See the AWS Bedrock AgentCore integration guide for a 5-minute end-to-end recipe.

API

agent402Tools(opts?: {
  baseUrl?: string;       // default "https://agent402.tools"
  slugs?: string[];       // restrict to these tool slugs (recommended)
  freeOnly?: boolean;     // default true — only compute-payable tools (no wallet)
  fetch?: typeof fetch;   // an @x402/fetch-wrapped fetch (only for wallet-only tools)
}): Promise<{
  tools:   StrandsTool[];                       // pass to `new Agent({ tools })`
  execute: (name, args) => Promise<unknown>;    // pays under the hood
  client:  Agent402;                            // raw buyer SDK (find()/call()/clearCache())
}>;

agent402Execute(opts?: {
  baseUrl?: string;
  fetch?: typeof fetch;
}): (name, args) => Promise<unknown>;

freeOnly: true (the default) filters to the ~1,061 compute-payable tools — every one of them works with no wallet, paid in seconds of CPU via proof-of-work. Set freeOnly: false and pass an @x402/fetch-wrapped fetch to access the ~47 wallet-only tools (network/disk-touching ones).

Sibling adapters

Same shape, different framework:

• agent402-openai-tools — OpenAI function-calling
• agent402-anthropic-tools — Anthropic Messages
• agent402-ai-sdk — Vercel AI SDK
• agent402-langchain — LangChain JS / LangGraph
• agent402-llamaindex — LlamaIndex TS

Source: adapters/strands/. Issues + PRs welcome on the main repo. MIT licensed.