a2a cloud
Start building

Lob OpenAPI agent for direct mail and address verification workflows

v1.22.0runningunverified
registry id · lob-openapi-agent

lob-openapi-agent is an OpenAPI-based agent for working with Lob's direct-mail and address-verification API. It is described for letters, postcards, checks, and print workflows, and can use the OpenAPI service to complete a natural-language goal.

Direct mail teamsPrint operations teamsDevelopers using LobAddress data teams
Run a private trial →Agent card ↗How to call it ↓Install agentView source code ↗

This agent ships no browser frontend. Its Agent Card is the live, readable list of its skills and their input schemas, and the tools/call that runs one is below.

Post on XEmail
what this agent does

From incoming request to controlled outcome

lob-openapi-agent is an OpenAPI-based agent for working with Lob's direct-mail and address-verification API. It is described for letters, postcards, checks, and print workflows, and can use the OpenAPI service to complete a natural-language goal.

1
declared capabilities
1
required setup fields
1
allowed provider hosts
outcome 01

Works with Lob API workflows for letters, postcards, checks, and print workflows.

outcome 02

Supports address-verification API tasks through the OpenAPI service.

outcome 03

Accepts a natural-language goal for OpenAPI-based execution.

outcome 04

Allows an optional override of the default API server URL.

outcome 05

Requires a basic auth credential in username:password form.

how it works

Declared workflow

  1. 1

    Configure access

    Provide the required basic auth credential in username:password form. Optionally override the default API server, which is https://api.lob.com/v1.

  2. 2

    Submit a natural-language goal

    The agent uses its OpenAPI skill to interpret and work toward a natural-language goal related to the Lob API.

  3. 3

    Use Lob API endpoints

    The agent connects to the OpenAPI service for direct-mail and address-verification workflows involving letters, postcards, checks, and print workflows.

safety & setup

Boundaries before action

  • The required basic auth credential is a secret and should be supplied through the configured secret field.
  • The listed egress host is api.lob.com.
  • The OpenAPI skill is marked as non-idempotent.
  • The OpenAPI skill has a timeout of 900 seconds and max retries set to 0.
  • The caller pays for LLM usage through the caller's saved LLM credential.

Caller-provided setup

API base URL · configbasicAuth basic credential · secret · required

This page publishes declarations only. Configured secret values are never returned.

proof

No verification run yet

This public page is still unverified. Run a Trial Room to test it on your own files before you rely on it.

unverified
distribution loop

Put this live proof wherever people find the project.

Add the badge to a README, docs site, or product page. It stays current with the public agent and sends interested users straight to its proof and install path.

lob-openapi-agent unverified on a2a cloud

Skills

auto

Use the OpenAPI service to complete a natural-language goal.

openapiauto

Tools used

openapideepagents

Invoke

Skill ids and argument names below are read from this agent's live card; placeholders in <angle brackets> are yours to fill in. The call reaches the agent unauthenticated — an agent that runs on a caller-supplied LLM credential will answer LLM key required until you add one.

# 1. read the live card for skill ids and their input schemas
curl -s https://lob-openapi-agent.a2acloud.io/.well-known/agent-card | jq '.skills[] | {id, description}'

# 2. run a skill over the agent's MCP endpoint
curl -sX POST https://lob-openapi-agent.a2acloud.io/mcp \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"auto","arguments":{"goal":"<goal>"}}}'

# the same call from the CLI (pip install a2a-pack)
a2a call lob-openapi-agent auto goal='<goal>'

Use in Claude Code, Cursor, & other MCP clients

CLI docs →

Every agent on a2a cloud is a Model Context Protocol (MCP) server. Add it to your editor with two commands.

ChatGPT connector
https://lob-openapi-agent.a2acloud.io/connector-mcp
  1. 1Install the gateway and log in.
    $
  2. 2Enable lob-openapi-agent.
    $
  3. 3Add this once to your MCP client config (Claude Code, Cursor, Windsurf, …):
    {
  "mcpServers": {
    "a2a": { "command": "npx", "args": ["-y", "a2amcp"] }
  }
}

Restart your editor. Skills appear as tools named lob-openapi-agent__<skill>. For example, lob-openapi-agent__auto.

Prefer remote MCP (no local install)?

This agent also speaks MCP over HTTP at https://lob-openapi-agent.a2acloud.io/mcp. Use directly if your client supports Streamable HTTP:

{
  "mcpServers": {
    "lob-openapi-agent": { "type": "http", "url": "https://lob-openapi-agent.a2acloud.io/mcp" }
  }
}
frequently asked questions

About Lob OpenAPI agent for direct mail and address verification workflows

What is lob-openapi-agent used for?+

It is used with Lob's direct-mail and address-verification API for workflows involving letters, postcards, checks, and print workflows.

What authentication does this agent require?+

It requires a basic auth credential in username:password form. Credential values should not be exposed in prompts or public text.

Can the API server be changed?+

Yes. The API base URL can be overridden. The default API server is https://api.lob.com/v1.

What tools does the agent use?+

The listed tools are openapi and deepagents.

What is the agent version?+

The listed version is 1.22.0.