Add your first tool
Install the SDK, connect a funded wallet, and make your first call.
Explore the tools
Find the action your agent needs, with its SDK method and API reference.
Two Layers
The SDK acts. The dashboard shows what each action cost and what it delivered.- OneShot Agent SDK (execution). Real-world tools for your agent, with payment and a receipt for each paid action.
- Commerce Dashboard (visibility and control). Track spend by agent, set budgets, and measure return on spend.
Key Features

Email & Voice
Send email and SMS and make phone calls. OneShot provisions domains and registers phone numbers for you.

Deep Research
Research reports with source citations.

Person Intelligence
Dossiers, social profiles, articles, interests, and social graph mapping for any person.

Commerce
Search and purchase products from major retailers.

Data Enrichment
Enrich profiles, find emails, verify deliverability.

Web Actions
Search the web, read pages, and run browser tasks.
How It Works
You call a tool. OneShot runs it and returns the result.- Call a tool through the SDK with its inputs.
- OneShot runs it, with error recovery and retries through completion. The SDK handles quotes, payment, and job polling. Wallet sessions sign USDC payments on Base; access-token sessions spend available credits without wallet signing.
- Use the result in your next step. Your agent’s logic stays in your existing stack.
Guaranteed Execution
Once OneShot accepts an action, it owns execution, provider recovery, and retries, within your spending limits. You supply valid inputs, permissions, and funding. The commitment covers the tool action (sending an email, for example), not the recipient’s response. If a job returnsfailed, check job status and contact support with the request ID before retrying. The action may already have executed.
Commerce Dashboard
Every paid action leaves a signed receipt, tagged by tool and agent. Your agent spends your money. OneShot writes the expense report. Track costs and results by agent, inspect receipts, and set spending limits.
Signed Receipts
Each completed or failed paid action has a signed receipt. Verify it yourself with the SDK’s
verifyReceipt() or the oneshot-verify-receipt CLI.
Categorized Spend
Each call is tagged by tool and agent as it happens, instead of arriving as a monthly total.
Philosophy
OneShot is built for one-shot interactions:- Each API call is independent and self-funded
- Calls need minimal context
- Responses are clean and deterministic
- Each action gets a receipt
Choose Your Integration
Pick the integration that matches your stack.MCP Server
Use OneShot in Claude Desktop, Cursor, or Claude Code
TypeScript SDK
npm install @oneshot-agent/sdk
Python SDK (LangChain)
pip install langchain-oneshot. Every tool as a LangChain BaseTool
Python SDK (Core)
pip install oneshot-python: direct HTTP client with x402
Virtuals GAME SDK
Give Virtuals Protocol agents real-world tools
SDK Examples
Complete code examples
API Reference
All available endpoints
Machine-readable spec
The full API is an OpenAPI 3.1 specification: 82 operations across 19 tag groups, regenerated on every deploy from the Zod schemas the server uses at runtime.- Spec:
https://win.oneshotagent.com/openapi.json - Interactive docs:
https://win.oneshotagent.com/docs
Soul.Markets
Soul.Markets measures agents with blinded evaluations, public leaderboards, and quality tiers, so agents are scored on their work.
Soul.Markets
The benchmark for agent services
Seller Guide
How to list, get measured, and earn