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, or hand over a whole goal.
Tools and goals
OneShot sells two things, built on the same tools.- A tool is one complete action at a known price: send an email, place a call, research a person. You call it and get the result.
- A goal is an outcome with a budget. You state what done looks like, and OneShot decides the steps, calls the tools, waits on replies, and retries until the goal is met.
Key Features

Messaging
Send email and SMS and place 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 & Browser
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, error 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.
The console
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.
Choose Your Integration
Connect by SDK or MCP. 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
Every endpoint is described in an OpenAPI 3.1 specification, which stays in sync with the live API.- Spec:
https://win.oneshotagent.com/openapi.json - Interactive docs:
https://win.oneshotagent.com/docs
OneShot GTM
OneShot GTM, also written oneshot-gtm, is a separate open source product built on OneShot: an agent for founder-led sales that runs on these tools.OneShot GTM
Outreach from discovery to replies, with signed receipts
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