How to Use the Lob MCP in LangChain

Q: How does LangChain handle errors when calling Lob to cancel a letter?

If your agent calls cancelletter on a document that is already in production, the Lob API returns an error. LangChain catches this exception, allowing your agent to log the failure in LangSmith and notify your team.

Run multi-step direct mail and address verification pipelines using LangChain agents and the Lob MCP Server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Lob MCP to LangChain

Create your Vinkius account to connect Lob to LangChain and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Lob with LangChain

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Chain address verification with physical mail in LangChain

The `verify_us_address` tool checks and standardizes delivery details before your LangChain agent attempts to mail anything through Lob. LangChain connects this verification step directly to your physical mailing logic, passing the sanitized output to `create_letter` or `create_postcard` without manual intervention. LangChain manages this Lob mailing sequence as a strict, observable chain. If the address validation tool flags an address as undeliverable, the chain halts so you don't waste money printing a physical letter.

Track Lob status changes using LangSmith tracing

The `list_letters` tool retrieves status updates, tracking numbers, and delivery dates for sent physical mail. When your LangChain agent calls this Lob tool, every request and response is recorded in LangSmith so you can trace the exact latency of your mail tracking queries. You see the raw inputs and outputs of `get_letter` directly in your LangSmith dashboard. That's how you debug why a LangChain agent failed to find a Lob tracking ID or why a status check stalled.

Secure check dispatch using this MCP Server

The `create_bank_account` tool registers your funding source, while `create_check` prints and mails physical checks via Lob. LangChain agents execute these tools sequentially, verifying the bank account details before queuing the check for production. You write a LangChain ReAct loop where the agent checks the balance, verifies the recipient's address, and triggers the Lob check. If any step fails, the LangChain framework catches the error and prevents the paper payment from going out.

Setup guide

Set up Lob MCP in LangChain

Prerequisites

Python 3.10+ installed
langchain-mcp-adapters + langgraph packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run pip install langchain-mcp-adapters langgraph langchain-openai. The MCP adapters package converts MCP tools into native LangChain BaseTool objects.
2

Connect via HTTP transport
Use MultiServerMCPClient with "transport": "http" pointing to your Vinkius endpoint. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Create a ReAct agent
Pass the discovered tools to create_react_agent() from LangGraph. The agent automatically routes Lob tool calls through the MCP protocol.
4

Run with any LLM
Swap ChatOpenAI for ChatAnthropic, ChatGoogleGenerativeAI, or any LangChain-compatible model. The MCP tools work identically across all providers.

agent.py

from langchain_mcp_adapters.client import MultiServerMCPClient
from langgraph.prebuilt import create_react_agent
from langchain_openai import ChatOpenAI

async with MultiServerMCPClient({
    "lob-mcp": {
        "transport": "http",
        "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
    }
}) as client:
    tools = client.get_tools()

    agent = create_react_agent(
        ChatOpenAI(model="gpt-4o"),
        tools,
    )
    result = await agent.ainvoke({
        "messages": "List recent Lob transactions"
    })
    print(result["messages"][-1].content)

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Lob. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Lob now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Lob MCP in LangChain

Install langchain-mcp-adapters and langgraph via pip. Initialize the MultiServerMCPClient with the Vinkius connection URL, call get_tools(), and pass those tools directly to your LangChain agent.

Yes, you can build a chain where the agent uses autocomplete_us_address to resolve partial strings. The LangChain agent then feeds the completed string to verify_us_address before generating the final mail piece.

If your agent calls cancel_letter on a document that is already in production, the Lob API returns an error. LangChain catches this exception, allowing your agent to log the failure in LangSmith and notify your team.

Absolutely, you can mix these mailing tools with over 500 other integrations in a single chain. For example, your agent can pull invoice data from a database and immediately pass it to create_letter to send a paper invoice.

All transit data, including US street addresses and bank routing numbers, goes through a secure V8 isolate sandbox on Vinkius. Your API keys are managed securely, and the server never stores your financial data or recipient lists locally.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript