Overview
langchain-oneshot is a Python package that wraps all 31 OneShot tools as LangChain BaseTool subclasses. It handles x402 payment signing automatically so your LangChain or LangGraph agents can send emails, make phone calls, run research, buy products, and more.
This package ports the same HTTP + x402 payment flow from the TypeScript SDK into Python, using
eth-account for EIP-712 signing and httpx for HTTP.Installation
Requirements
- Python 3.10+
- A wallet private key (for x402 payment signing)
- USDC on Base Mainnet
Dependencies
Quick Start
With LangGraph Agent
Individual Tools
Configuration
The SDK operates on Base Mainnet with real USDC. Fund your agent wallet before making paid tool calls.
Available Tools
See Pricing for current tool costs.
Communication
Research & Enrichment
Person Intelligence
Browser
Web
Commerce
Build
Inbox
Account
Examples
Send an Email
Deep Research
Find and Verify an Email
Build a Website
Browser with Persistent Profile
Full Agent with Selective Tools
How Payments Work
Paid tools use the x402 protocol. The flow is fully automatic:- Your agent calls a tool (e.g.
ResearchTool.invoke(...)) - The client POSTs to the OneShot API
- The API returns 402 Payment Required with a USDC quote
- The client signs a
TransferWithAuthorization(EIP-3009) locally using your private key - The client re-POSTs with the signed payment in the
x-paymentheader - The API processes the job and returns the result
Links
langchain-oneshot on PyPI
LangChain integration package
oneshot-python on PyPI
Core Python SDK (dependency of langchain-oneshot)
TypeScript SDK
TypeScript SDK docs
MCP Server
MCP integration for Claude, Cursor
GitHub
Source code
Pricing
Detailed pricing