langchain-oneshot 0.3.1

LangChain tools for OneShot — commercial actions for AI agents

langchain-oneshot

LangChain tools for OneShot — commercial actions for AI agents.

Provides 26 tools as LangChain BaseTool subclasses with automatic x402 payment handling via USDC on Base.

Installation

pip install langchain-oneshot

Quick Start

from langchain_oneshot import OneShotToolkit
from langchain_openai import ChatOpenAI
from langgraph.prebuilt import create_react_agent

# Create toolkit (test mode uses Base Sepolia testnet)
toolkit = OneShotToolkit.from_private_key(
    private_key="0x...",
    test_mode=True,
)

# Use all 26 tools with a LangGraph agent
tools = toolkit.get_tools()
llm = ChatOpenAI(model="gpt-4o")
agent = create_react_agent(llm, tools)

result = agent.invoke({
    "messages": [("user", "Research the latest AI agent frameworks")]
})

Individual Tools

from langchain_oneshot import OneShotClient, ResearchTool

client = OneShotClient(private_key="0x...", test_mode=True)
research = ResearchTool(client=client)
result = research.invoke({"topic": "AI agent frameworks 2026"})

Available Tools

Tool	Description
oneshot_email	Send emails
oneshot_voice	Make phone calls
oneshot_sms	Send SMS messages
oneshot_research	Deep web research
oneshot_web_search	Search the web
oneshot_people_search	Search for people
oneshot_enrich_profile	Enrich a profile
oneshot_find_email	Find email address
oneshot_verify_email	Verify email
oneshot_deep_research_person	Full dossier on a person
oneshot_social_profiles	Find all social accounts
oneshot_article_search	Find articles about a person
oneshot_person_newsfeed	Recent social posts
oneshot_person_interests	Analyze interests
oneshot_person_interactions	Map followers/following
oneshot_commerce_search	Search products
oneshot_commerce_buy	Purchase product
oneshot_build	Build a website
oneshot_update_build	Update a website
oneshot_inbox_list	List inbox emails
oneshot_inbox_get	Get email by ID
oneshot_sms_inbox_list	List SMS inbox
oneshot_sms_inbox_get	Get SMS by ID
oneshot_notifications	List notifications
oneshot_mark_notification_read	Mark read
oneshot_get_balance	USDC balance

Paid tools are priced in USDC via x402. See Pricing for current rates.

How Payments Work

Paid tools use the x402 protocol. When a tool requires payment:

1. The client POSTs to the tool endpoint
2. The API returns 402 Payment Required with a quote
3. The client signs a USDC TransferWithAuthorization (EIP-3009) using your private key
4. The client re-POSTs with the signed payment header
5. The API processes the request and returns the result

All payment signing happens locally — your private key never leaves your machine.

Configuration

# Test mode (Base Sepolia — no real money)
toolkit = OneShotToolkit.from_private_key("0x...", test_mode=True)

# Production (Base Mainnet — real USDC)
toolkit = OneShotToolkit.from_private_key("0x...", test_mode=False)

Requirements

• Python 3.10+
• langchain-core >= 0.3.0
• oneshot-python >= 0.2.0
• pydantic >= 2.0

Links

• Documentation
• oneshot-python on PyPI — Core HTTP client (dependency)
• TypeScript SDK
• MCP Server
• GitHub

License

MIT