Skip to main content

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:
  1. Your agent calls a tool (e.g. ResearchTool.invoke(...))
  2. The client POSTs to the OneShot API
  3. The API returns 402 Payment Required with a USDC quote
  4. The client signs a TransferWithAuthorization (EIP-3009) locally using your private key
  5. The client re-POSTs with the signed payment in the x-payment header
  6. The API processes the job and returns the result
Your private key never leaves your machine. All signing happens locally via eth-account.

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