Integrations

Epanya is designed to plug into any agentic framework. Every major orchestration library can call the Epanya API directly or through the official SDKs — the same two-round x402 purchase flow works identically across all of them.

Language support: The JavaScript/TypeScript SDK works with Claude, OpenAI, and any Node.js-based framework. The Python SDK works with LangChain, CrewAI, and any Python-based framework.

Available guides

Claude & Anthropic SDK

Give Claude tools to discover and purchase marketplace products using tool_use / function calling. Works with the TypeScript and Python Anthropic SDKs.

Read guide →

OpenAI / GPT

Wire up GPT-4 function calling to Epanya. Define discover_products, purchase_product, and check_budget as OpenAI tools and let GPT decide when to buy.

Read guide →

LangChain

Create EpanyaDiscoverTool and EpanyaPurchaseTool as LangChain BaseTool subclasses. Drop them into any AgentExecutor or LCEL chain.

Read guide →

CrewAI

Build a procurement crew with a dedicated purchasing agent. Includes @tool-decorated functions and a full multi-agent crew that researches, discovers, and buys compute resources.

Read guide →

How it works in any framework

The integration pattern is the same regardless of which orchestration layer you use:

Define tools / functions that call epanya.discover() and epanya.purchase().
Register those tools with your LLM or agent executor.
The model decides autonomously when to search the marketplace and when to buy.
Your code receives the endpointUrl and calls the purchased service.

Common tool surface

Every integration guide defines variants of the same three tools:

Tool	Description	Returns
`discover_products`	Search marketplace by query, category, and max price	Array of matching products with names, prices, and IDs
`purchase_product`	Purchase a product by ID via x402 payment	Transaction ID and endpoint URL to call the service
`check_budget`	Check how much USDC the agent has spent vs its limit	Spent amount, budget limit, and whether budget is exceeded

Prerequisites

Before starting any integration guide, you'll need:

An Ethereum wallet address for your agent (the buyer)
A signer function that can sign EIP-3009 transferWithAuthorization messages — see the signers guide
The relevant SDK installed (npm install @epanya/agent-sdk or pip install epanya)

Start with test mode: All guides use createTestSigner / create_test_signer so you can run the full flow without spending real USDC. Set X402_TEST_MODE=true in your environment and the API accepts test payments.