← All guides · Markdown: /guides/langchain-python.md

LangChain (Python): a paid @tool for create_agent

Give a LangChain Python agent one of the shop's tools: a @tool function, paid per call with x402, free trial first.

For: LangChain 1.x. Endpoint shape: GET https://shop.lordevo.com/api/quick/<tool>?<input>; (HTTP 402 with x402 terms until paid). All guides: https://shop.lordevo.com/guides

Easier: use the SDK: https://shop.lordevo.com/guides/sdk/langchain-python

Prerequisites

Code

Put the helper from https://shop.lordevo.com/guides/python in lordevo.py next to this file.

# pip install langchain   (plus the helper's packages)
import os
from langchain.agents import create_agent
from langchain.tools import tool
from lordevo import lordevo_tool  # tries a free trial call first (X-Lordevo-Trial: 1), then pays


@tool
def dns_lookup(host: str, type: str | None = None) -> str:
    """DNS records lookup (A, AAAA, CNAME, MX, TXT, NS, SOA, CAA). Costs $0.003 per call (x402, USDC on Base); 3 free trial calls per IP per UTC day (shared by all tools up to $0.005). Instant tools that fail or are refused are not charged. Long jobs (202) are charged when accepted and are not refunded automatically if they fail later. If a paid job failed, email hello@lordevo.com with the transaction hash and we'll review it, usually within 2 business days.

    Args:
        host: Host name to look up, e.g. example.com or mail.example.com (a URL also works; the host part is used)
        type: Record type (default ALL = A, AAAA, CNAME, MX, TXT, NS, SOA, CAA) One of ALL, A, AAAA, CNAME, MX, TXT, NS, SOA, CAA.
    """
    return lordevo_tool("dns-lookup", {"host": host, "type": type})


# Any chat model LangChain supports, e.g. "openai:<model>" or "anthropic:<model>" (provider key in its usual env variable).
agent = create_agent(os.environ["LANGCHAIN_MODEL"], tools=[dns_lookup])
out = agent.invoke({"messages": [{"role": "user", "content": "Use the dns_lookup tool on example.com and summarise the answer."}]})
print(out["messages"][-1].content)

Or all 58 tools at once from the shop's package: pip install "lordevo-x402>=0.1.5", then from lordevo_x402.langchain import langchain_tools and langchain_tools(sync_client=LordevoSync.from_private_key(os.environ["AGENT_WALLET_KEY"])).

Try it free (no wallet)

lordevo_tool() always tries a free call first (3 per IP per UTC day on tools up to $0.005). Without AGENT_WALLET_KEY the agent gets {"error": "http_402", ...} once they are used up.

Errors (nothing is charged on any of these)

The tool never raises: errors reach the model as JSON (error, message, retry_after_seconds, charged: false).

Next tools to try

Checked

Written 2026-10-30 against the current public docs:

The snippets follow those docs; they were not executed end to end by the shop. Tell us if something has moved: hello@lordevo.com