How to Use the Lob MCP in Windsurf

Q: Can Windsurf use Lob to fix bad addresses?

Yes. You can prompt the agent to run verifyusaddress on your customer database. It standardizes the format before you send any mail.

Q: Does this support custom templates?

It does. You can use createtemplate to save HTML designs, then reference them by ID when you generate letters or postcards.

Q: What happens if a mailing fails?

You can query the status using getletter or getcheck. If the address is invalid, the API returns the error, and you can correct it in your source data.

Automate physical mail directly from your Windsurf editor. Connect the Lob MCP Server to trigger letters and checks without leaving code.

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 Windsurf

Create your Vinkius account to connect Lob to Windsurf 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 Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Sequence mail jobs in Windsurf

Cascade reads your codebase to trigger physical mailings based on app events. It chains `verify_us_address` with `create_letter` to ensure every document hits the right mailbox. You avoid manual data entry. The agent handles the logic, pulling recipient data from your files and passing it to the API.

Manage your Lob account status

You get full visibility into your mailing queue inside the editor. Use `list_letters` or `list_checks` to check delivery progress without switching contexts. If you catch a mistake early, call `cancel_letter` before it hits the production floor. It keeps your physical operations as agile as your software deployment.

Automate financial disbursements

Set up recurring payments by linking your bank account through `create_bank_account`. Once ready, Cascade executes `create_check` to send payments automatically. The tool generates the necessary records, so you keep an audit trail of every transaction. It removes the friction of printing and mailing checks by hand.

Setup guide

Set up Lob MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Lob MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Lob payment history." If connected, Cascade will call the Lob tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "lob-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

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 Windsurf

Open your Windsurf settings and navigate to the Cascade MCP section. Add the server configuration there, and your agent will pick up the tools immediately.

Yes. You can prompt the agent to run `verify_us_address` on your customer database. It standardizes the format before you send any mail.

Lob keeps your sensitive recipient info on their secure servers. The MCP connection only passes the specific data needed to fulfill your requested mail job.

It does. You can use `create_template` to save HTML designs, then reference them by ID when you generate letters or postcards.

You can query the status using `get_letter` or `get_check`. If the address is invalid, the API returns the error, and you can correct it in your source data.

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