How do AI agents use Lob through Open Connector?

Your user connects Lob once with one of its cataloged authentication methods. Open Connector stores the credential in an encrypted vault and exposes Lob tools to your agent over MCP or a typed API, with credentials injected server-side on each call.

Is this a Lob MCP server?

Yes. Open Connector can serve Lob as a named MCP server with a scoped allowlist and a per-user connection URL, so any MCP client can call Lob actions with credentials injected server-side.

Where do Lob credentials live?

In your own infrastructure. Open Connector keeps credentials in its own vault and injects them at call time, so they never leave your environment.

Lob integration

Lob integration for AI agents.

Lob integration for AI agents with secure authentication and server-side credential injection. Open Connector runs the OAuth, seals the token in an encrypted vault, and serves Lob tools to your agent over MCP or a typed API — credentials injected server-side, every call audited, nothing leaving your infrastructure. Open source (AGPL-3.0) and self-hostable.

View source on GitHub All integrations →

What your agents can do

Real Lob actions, managed and audited.

Your user connects Lob once; your agent can then use the Lob API to manage direct mail, addresses, postcards, letters, checks, campaigns, templates, verification, and billing resources — scoped to the OAuth permissions you grant and the tool allowlist you configure. Every action is least-privilege and written to a tamper-evident audit trail.

1
Your user grants Lob access once (OAuth) — the token lands in the vault.
2
Your agent calls a tool over MCP or the typed API; Open Connector injects the credential server-side.
3
Every routed call appends a hash-chained audit record — nothing leaves your infra.

Tools & triggers

Supported Lob tools.

105 tools are generated from the published Lob catalog. Descriptions are plain text; each action remains subject to its configured authentication and tool allowlist.

Showing 105 tools. All published catalog entries are included in this page's server-rendered HTML.

Create: Creates a new address given information; Addresses
Delete: Deletes the details of an existing address. You need only supply the unique identifier that was returned upon address creation.; Addresses
Retrieve: Retrieves the details of an existing address. You need only supply the unique identifier that was returned upon address creation.; Addresses
List: Returns a list of your addresses. The addresses are returned sorted by creation date, with the most recently created addresses appearing first.; Addresses
Autocomplete: Given an address prefix consisting of a partial primary line, as well as optional input of city, state, and zip code, this functionality returns up to 10 full US address suggestions. Not all of them will turn out to be valid addresses; they'll need to be [verified](#operation/verification_us).; US Autocompletions
Create: Creates a new bank account with the provided properties. Bank accounts created in live mode will need to be verified via micro deposits before being able to send live checks. The deposits will appear in the bank account in 2-3 business days and have the description "VERIFICATION".; Bank Accounts
Delete: Permanently deletes a bank account. It cannot be undone.; Bank Accounts
Retrieve: Retrieves the details of an existing bank account. You need only supply the unique bank account identifier that was returned upon bank account creation.; Bank Accounts
Verify: Verify a bank account in order to create a check. Check the `microdeposit_type` field returned by `GET /v1/bank_accounts/:id` to determine which parameter to submit: - `amounts` — provide the two microdeposit amounts (in cents) that appeared in the bank account statement. - `descriptor_code` — provide the 6-character code (beginning with `SM`) from the bank statement descriptor of the single $0.01 microdeposit. Submitting the wrong parameter type for the account's `microdeposit_type` will return an error.; Bank Accounts
List: Returns a list of your bank accounts. The bank accounts are returned sorted by creation date, with the most recently created bank accounts appearing first.; Bank Accounts
Create: Creates a new billing_group with the provided properties.; Billing Groups
Retrieve: Retrieves the details of an existing billing_group. You need only supply the unique billing_group identifier that was returned upon billing_group creation.; Billing Groups
Update: Updates all editable attributes of the billing_group with the given id.; Billing Groups
List: Returns a list of your billing_groups. The billing_groups are returned sorted by creation date, with the most recently created billing_groups appearing first.; Billing Groups
Create: Creates a new booklet.; Booklets
Delete: Completely removes a booklet from production. This can only be done if the booklet's `send_date` has not yet passed. If the booklet is successfully canceled, you will not be charged for it.; Booklets
Retrieve: Retrieves the details of an existing booklet. You need to only supply the unique booklet identifier that was returned upon booklet creation.; Booklets
List: Returns a list of your booklets. The booklets are returned sorted by creation date, with the most recently created booklets appearing first.; Booklets
Create: Creates a new buckslip given information; Buckslips
Delete: Delete an existing buckslip. You need only supply the unique identifier that was returned upon buckslip creation.; Buckslips
Create: Creates a new buckslip order given information; Buckslip Orders
Retrieve: Retrieves the buckslip orders associated with the given buckslip id.; Buckslip Orders
Retrieve: Retrieves the details of an existing buckslip. You need only supply the unique customer identifier that was returned upon buckslip creation.; Buckslips
Update: Update the details of an existing buckslip. You need only supply the unique identifier that was returned upon buckslip creation.; Buckslips
List: Returns a list of your buckslips. The buckslips are returned sorted by creation date, with the most recently created buckslips appearing first.; Buckslips
Bulk Verify: Verify a list of international (except US or US territories) address _with a live API key_. Requests to this endpoint with a test API key will return a dummy response based on the primary line you input.; Intl Verifications
Bulk Verify: Verify a list of US or US territory addresses _with a live API key_. Requests to this endpoint with a test API key will return a dummy response based on the primary line you input.; US Verifications
Create: Creates a new campaign with the provided properties. See how to launch your first campaign [here](https://help.lob.com/print-and-mail/building-a-mail-strategy/campaign-or-triggered-sends/launch-your-first-campaign).; Campaigns
Delete: Delete an existing campaign. You need only supply the unique identifier that was returned upon campaign creation. Deleting a campaign also deletes any associated mail pieces that have been created but not sent. A campaign's `send_date` matches its associated mail pieces' `send_date`s.; Campaigns
Retrieve: Retrieves the details of an existing campaign. You need only supply the unique campaign identifier that was returned upon campaign creation.; Campaigns
Send Campaign: Sends a campaign. You need only supply the unique campaign identifier that was returned upon campaign creation.; Campaigns
Update: Update the details of an existing campaign. You need only supply the unique identifier that was returned upon campaign creation.; Campaigns
List: Returns a list of your campaigns. The campaigns are returned sorted by creation date, with the most recently created campaigns appearing first.; Campaigns
Create: Creates a new card given information; Cards
Delete: Delete an existing card. You need only supply the unique identifier that was returned upon card creation.; Cards
Create: Creates a new card order given information; Card Orders
Retrieve: Retrieves the card orders associated with the given card id.; Card Orders
Retrieve: Retrieves the details of an existing card. You need only supply the unique customer identifier that was returned upon card creation.; Cards
Update: Update the details of an existing card. You need only supply the unique identifier that was returned upon card creation.; Cards
List: Returns a list of your cards. The cards are returned sorted by creation date, with the most recently created addresses appearing first.; Cards
Cancel: Completely removes a check from production. This can only be done if the check has a `send_date` and the `send_date` has not yet passed. If the check is successfully canceled, you will not be charged for it. Read more on [cancellation windows](#section/Cancellation-Windows) and [scheduling](#section/Scheduled-Mailings). Scheduling and cancellation is a premium feature. Upgrade to the appropriate <a href="https://dashboard.lob.com/#/settings/editions" target="_blank">Print & Mail Edition</a> to gain access.; Checks
Create: Creates a new check with the provided properties.; Checks
Retrieve: Retrieves the details of an existing check. You need only supply the unique check identifier that was returned upon check creation.; Checks
List: Returns a list of your checks. The checks are returned sorted by creation date, with the most recently created checks appearing first.; Checks
Create: Creates a new template for use with the Print & Mail API. In Live mode, you can only have as many non-deleted templates as allotted in your current <a href="https://dashboard.lob.com/#/settings/editions" target="_blank">Print & Mail Edition</a>. If you attempt to create a template past your limit, you will receive a `403` error. There is no limit in Test mode.; Templates
Create: Creates a new template version attached to the specified template.; Template Versions
Create: Creates a new creative with the provided properties; Creatives
Retrieve: Retrieves the details of an existing creative. You need only supply the unique creative identifier that was returned upon creative creation.; Creatives
Update: Update the details of an existing creative. You need only supply the unique identifier that was returned upon creative creation.; Creatives
Create Domain: Add a new custom domain that can be used to create custom links.; URL Shortener
Delete a Domain: Delete a registered domain. This operation can only be performed if all associated links with the domain are deleted.; URL Shortener
Retrieve a domain: Retrieve details for a single domain.; URL Shortener
List all domains: Retrieve a list of all created domains.; URL Shortener
Retrieve Export: Retrieves the details of an existing export. You need only supply the unique export identifier that was returned upon export creation. If you try retrieving an export immediately after creating one (i.e., before we're done processing the export), you will get back an export object with `state = in_progress`.; Uploads
Get Lob Credits Balance: Returns the account's current balance of Lob Credits.; AccountsLob Credits
Identity Validation: Validates whether a given name is associated with an address.; Identity Validation
Create: Creates a new Informed Delivery campaign; Informed Delivery Campaign
List: List Informed Delivery campaigns; Informed Delivery Campaign
Retrieve: Retrieves the details of an existing Informed Delivery campaign. You need only supply the `usps_campaign_id` returned in the campaign creation request.; Informed Delivery Campaign
Update: Update the details of an existing Informed Delivery campaign.<br> **NOTE:** you can only update a campaign in the `pending_approval` status.; Informed Delivery Campaign
Single Verify: Verify an international (except US or US territories) address _with a live API key_. Requests to this endpoint with a test API key will return a dummy response based on the primary line you input.; Intl Verifications
Cancel: Completely removes a letter from production. This can only be done if the letter has a `send_date` and the `send_date` has not yet passed. If the letter is successfully canceled, you will not be charged for it. Read more on [cancellation windows](#section/Cancellation-Windows) and [scheduling](#section/Scheduled-Mailings). Scheduling and cancellation is a premium feature. Upgrade to the appropriate <a href="https://dashboard.lob.com/#/settings/editions" target="_blank">Print & Mail Edition</a> to gain access.; Letters
Create: Creates a new letter given information; Letters
Retrieve: Retrieves the details of an existing letter. You need only supply the unique letter identifier that was returned upon letter creation.; Letters
List: Returns a list of your letters. The letters are returned sorted by creation date, with the most recently created letters appearing first.; Letters
Create Link: Given a long URL, shorten your URL either by using a custom domain or Lob's own short domain.; URL Shortener
Update a Link: Update any of the properties of a shortened link.; URL Shortener
Delete Link: Delete the shortened link.; URL Shortener
Retrieve a link: Retrieves a single shortened link.; URL Shortener
List all links: Retrieves a list of shortened links. The list is sorted by creation date, with the most recently created appearing first.; URL Shortener
Create: Creates a new postcard given information; Postcards
Cancel: Completely removes a postcard from production. This can only be done if the postcard has a `send_date` and the `send_date` has not yet passed. If the postcard is successfully canceled, you will not be charged for it. Read more on [cancellation windows](#section/Cancellation-Windows) and [scheduling](#section/Scheduled-Mailings). Scheduling and cancellation is a premium feature. Upgrade to the appropriate <a href="https://dashboard.lob.com/#/settings/editions" target="_blank">Print & Mail Edition</a> to gain access.; Postcards
Retrieve: Retrieves the details of an existing postcard. You need only supply the unique customer identifier that was returned upon postcard creation.; Postcards
List: Returns a list of your postcards. The addresses are returned sorted by creation date, with the most recently created addresses appearing first.; Postcards
List: Returns a list of your QR codes. The QR codes are returned sorted by scan date, with the most recently scanned QR codes appearing first.; QR Codes
Retrieve Line Item Report: Retrieves the line item data for each row from the csv file associated with the upload id record. NOTE: This endpoint is currently feature flagged. Please reach out to Lob's support team if you would like access to this API endpoint.; Uploads
Create: Creates a new resource proof with the provided properties.; Resource Proofs
Retrieve: Retrieves the details of an existing resource proof. You need only supply the unique resource proof identifier.; Resource Proofs
Update: Updates the specified resource proof.; Resource Proofs
Reverse Geocode Lookup: Reverse geocode a valid US location with a live API key.; Reverse Geocode Lookups
Create: Creates a new self_mailer given information; Self Mailers
Delete: Completely removes a self mailer from production. This can only be done if the self mailer's `send_date` has not yet passed. If the self mailer is successfully canceled, you will not be charged for it. This feature is exclusive to certain customers. Upgrade to the appropriate <a href="https://dashboard.lob.com/#/settings/editions" target="_blank">Print & Mail Edition</a> to gain access.; Self Mailers
Retrieve: Retrieves the details of an existing self_mailer. You need only supply the unique self_mailer identifier that was returned upon self_mailer creation.; Self Mailers
List: Returns a list of your self_mailers. The self_mailers are returned sorted by creation date, with the most recently created self_mailers appearing first.; Self Mailers
Create: Creates a new snap_pack given information; Snap Packs
Delete: Completely removes a snap pack from production. This can only be done if the snap pack's `send_date` has not yet passed. If the snap pack is successfully canceled, you will not be charged for it.; Snap Packs
Retrieve: Retrieves the details of an existing snap_pack. You need to only supply the unique snap_pack identifier that was returned upon snap_pack creation.; Snap Packs
List: Returns a list of your snap_packs. The snap_packs are returned sorted by creation date, with the most recently created snap_packs appearing first.; Snap Packs
Delete: Permanently deletes a template. Deleting a template also deletes its associated versions. Deleted templates can not be used to create postcard, letter, or check resources.; Templates
Retrieve: Retrieves the details of an existing template. You need only supply the unique template identifier that was returned upon template creation.; Templates
Update: Updates the description and/or published version of the template with the given id. To update the template's html, create a new version of the template.; Templates
Delete: Permanently deletes a template version. A template's `published_version` can not be deleted.; Template Versions
Retrieve: Retrieves the template version with the given template and version ids.; Template Versions
Update: Updates the template version with the given template and version ids.; Template Versions
List: Returns a list of template versions for the given template ID. The template versions are sorted by creation date, with the most recently created appearing first.; Template Versions
List: Returns a list of your templates. The templates are returned sorted by creation date, with the most recently created templates appearing first.; Templates
Create: Creates a new upload with the provided properties.; Uploads
Delete: Delete an existing upload. You need only supply the unique identifier that was returned upon upload creation.; Uploads
Create Export: Campaign Exports can help you understand exactly which records in a campaign could not be created. By initiating and retrieving an export, you will get row-by-row errors for your campaign. For a step-by-step walkthrough of creating a campaign and exporting failures, see our [Campaigns Guide](https://help.lob.com/print-and-mail/building-a-mail-strategy/campaign-or-triggered-sends/launch-your-first-campaign). Create an export file associated with an upload.; Uploads
Upload file: Upload an [audience file](https://help.lob.com/print-and-mail/building-a-mail-strategy/campaign-or-triggered-sends/campaign-audience-guide) and associate it with an upload.; Uploads
Retrieve: Retrieves the details of an existing upload. You need only supply the unique upload identifier that was returned upon upload creation.; Uploads
Update: Update the details of an existing upload. You need only supply the unique identifier that was returned upon upload creation.; Uploads
List: Returns a list of your uploads. Optionally, filter uploads by campaign.; Uploads
Single Verify: Verify a US or US territory address _with a live API key_. The address can be in components (e.g. `primary_line` is "210 King Street", `zip_code` is "94107") or as a single string (e.g. "210 King Street 94107"), but not as both. Requests using a test API key validate required fields but return empty values unless specific `primary_line` values are provided. See the [US Verifications Test Environment](#section/US-Verifications-Test-Env) for details.; US Verifications
Lookups: Returns information about a ZIP code; Zip Lookups

FAQ

Lob integration, answered

How do AI agents use Lob through Open Connector?: Your user connects Lob once with one of its cataloged authentication methods. Open Connector stores the credential in an encrypted vault and exposes Lob tools to your agent over MCP or a typed API, with credentials injected server-side on each call.
Is this a Lob MCP server?: Yes. Open Connector can serve Lob as a named MCP server with a scoped allowlist and a per-user connection URL, so any MCP client can call Lob actions with credentials injected server-side.
Where do Lob credentials live?: In your own infrastructure. Open Connector keeps credentials in its own vault and injects them at call time, so they never leave your environment.

Give your agents Lob — keep the keys.

Open source, self-hostable, with Lob credentials that never leave your infrastructure. Run it from source today.

View source on GitHub How the MCP gateway works →