Quickstart

Install the SDK, point it at a funded wallet, and send an email. One call: the SDK gets the quote, signs the payment, and waits for the result. The code below is the whole integration.

Install the SDK

npm
bun
pip (Python)

bash npm install @oneshot-agent/sdk

bash bun add @oneshot-agent/sdk

bash pip install langchain-oneshot

Send Your First Email

CDP Wallet (Recommended)
Private Key

Your config holds no private keys. Signing happens in Coinbase’s secure enclave.

import { OneShot } from "@oneshot-agent/sdk";

// Reads CDP_API_KEY_ID, CDP_API_KEY_SECRET, CDP_WALLET_SECRET from env
const agent = await OneShot.create({ cdp: true });

// The SDK handles quoting, payment signing, and job polling
await agent.email({
  to: "[email protected]",
  subject: "Hello from OneShot",
  body: "This was sent autonomously.",
});

Get CDP credentials at Coinbase Agentic Wallet.

For agents that manage their own keys.

import { OneShot } from "@oneshot-agent/sdk";

const agent = new OneShot({
  privateKey: process.env.AGENT_PRIVATE_KEY,
});

await agent.email({
  to: "[email protected]",
  subject: "Hello from OneShot",
  body: "This was sent autonomously.",
});

Behind that one call, the SDK:

Gets a price quote from the API
If paying with ETH, tops up USDC via Uniswap V3 when the balance runs low
Signs a USDC payment authorization with your wallet
Submits the signed payment and request
Polls until the job completes

The SDK operates on Base Mainnet with real USDC. Fund your agent wallet before making paid tool calls.

What Just Happened

That one call ran a full payment exchange. The SDK used the x402 payment protocol:

Your code:  agent.email({ to, subject, body })
    ↓
SDK:        POST /v1/tools/email/send  →  API returns 402 + price quote
    ↓
SDK:        Signs USDC TransferWithAuthorization (EIP-712)
    ↓
SDK:        Retries with payment-signature header  →  API accepts, queues job
    ↓
SDK:        Polls job status until complete  →  Returns result

You can do the same by hand with curl. The API Reference documents the raw endpoints.

Try More Tools

Every tool uses the same call pattern. Prices are on the Pricing page. A wallet call pays with x402, and its 402 quote carries the exact price before anything is charged. Calls paid from prepaid credits, such as an access-token session or the voice number purchase, are charged when the API accepts the request, before the work runs (a synchronous lookup answers 200, the number purchase 201, a queued job 202); a 402 there means insufficient credits, and nothing was charged or bought.

// Research a topic
const report = await agent.research({
  topic: "Latest AI agent frameworks",
  depth: "quick",
});
console.log(report.report_content);

// Check your inbox (free)
const inbox = await agent.inboxList({ limit: 10 });

// Check your wallet balance (free)
const balance = await agent.getBalance(agent.usdcAddress);
console.log(`Balance: ${balance} USDC`);

Advanced Configuration

Both overrides are optional.

const agent = await OneShot.create({
  cdp: true,
  baseUrl: "https://win.oneshotagent.com", // Optional: override API endpoint
  rpcUrl: "https://rpc.example.com",        // Optional: override RPC endpoint
});

Next Steps

SDK Examples

Email, voice, SMS, research, commerce, and build examples

API Reference

Raw endpoint docs for all tools

Pricing

Cost per endpoint

LangChain (Python)

Python integration with 48 LangChain tools plus the lookup tools

MCP Server

Use OneShot in Claude Desktop or Cursor

Get Started

Organizations

SDK

Install the SDK

Send Your First Email

What Just Happened

Try More Tools

Advanced Configuration

Next Steps

SDK Examples

API Reference

Pricing

LangChain (Python)

MCP Server

​Install the SDK

​Send Your First Email

​What Just Happened

​Try More Tools

​Advanced Configuration

​Next Steps

SDK Examples

API Reference

Pricing

LangChain (Python)

MCP Server

Install the SDK

Send Your First Email

What Just Happened

Try More Tools

Advanced Configuration

Next Steps