# Stannp — MCP server on mcp.ai
> Connect your Stannp account and use 32 tools for marketing automation straight from your AI agent. Connect with your own API key. Stannp provides a direct mail API enabling users to send postcards and letters programmatically.

By: mcp.ai · official
Page: https://mcp.ai/stannp

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_stannp?ms=1787291340000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/stannp/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/stannp/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/stannp/skill.md
Postman collection (v2.1): https://mcp.ai/stannp/postman.json

## Tools
- stannp_add_recipient_to_group(city: string, email?: string, company?: string, country?: string, custom1?: string, custom2?: string, custom3?: string, address1: string, address2?: string, address3?: string, group_id: string, postcode: string, last_name: string, first_name: string) — Tool to add a recipient to a recipient group. Use when you need to add new mailing list subscribers.
- stannp_add_recipients_to_group(group_id: integer, recipients: string) — Tool to add existing recipients to a mailing list group. Use when you need to add recipients from your account to an existing group for campaign management.
- stannp_cancel_postcard(id: integer) — Tool to cancel a postcard if processing has not started yet. Use when you need to cancel a scheduled postcard before it enters production.
- stannp_create_campaign(back?: string, file?: string, name: string, save?: boolean, size?: string, type: string, front?: string, addons?: string, group_id: integer, template_id?: integer, what_recipients?: string) — Tool to create a new direct mail campaign on the platform. Use when you need to set up a campaign with recipients and design templates. Requires a valid group_id with recipients.
- stannp_create_campaign_sample(id: integer) — Tool to produce a PDF sample of your campaign. The generated link will be valid for 30 minutes. Use when you need to preview a campaign before sending it to recipients.
- stannp_create_folder(name: string) — Tool to create a folder in your secure file transfer area. Use when you need to organize files or prepare a storage location before uploading documents.
- stannp_create_group(name: string, description?: string) — Tool to create a new recipient group in Stannp. Use when you need to organize contacts into a distinct group before sending campaigns.
- stannp_create_letter(file?: string, tags?: string, test?: boolean, addons?: string, duplex?: boolean, template?: integer, clearzone?: boolean, recipient_id?: string, post_unverified?: boolean, recipient_details?: object) — Tool to create a letter with mail merge to insert address and variable data. Use when you need to send physical mail via Stannp API.
- stannp_create_postcard(back?: string, size: string, tags?: string, test?: boolean, front?: string, message?: string, recipient: object) — Tool to create a postcard. Use when you need to send a postcard via direct mail.
- stannp_create_selection(name?: string, filters: string, group_id: integer) — Tool to create a new recipient selection for targeting in Stannp. Use when you need to create an auto filter selection to target specific recipients within a group based on criteria.
- stannp_delete_group(id: integer, delete_recipients?: boolean) — Tool to delete a recipient group in Stannp. Recipients remain on your account unless delete_recipients is true. Use when you need to remove a mailing list group.
- stannp_delete_recipient(id: integer) — Tool to permanently delete a recipient from your account. Use when you need to remove a recipient from your mailing list.
- stannp_get_account_balance() — Tool to retrieve the current account balance. Use when you need to check available account funds.
- stannp_get_campaign(id: integer) — Tool to retrieve details of a specific campaign. Use when you need to get information about a campaign by its ID.
- stannp_get_campaign_available_dates(end: string, start: string) — Tool to get available dates for scheduling a campaign (up to 30 days). Use when you need to check which dates are available for campaign dispatch.
- stannp_get_campaign_cost(id: integer) — Tool to get the estimated cost of booking a campaign. Use when you need to calculate the total cost before booking a direct mail campaign.
- stannp_get_contact(contact_id: string) — Tool to retrieve details of a specific contact. Use when you need all stored fields of a contact by its ID.
- stannp_get_current_user() — Tool to get information about the currently authenticated user including rate limit status. Use when you need to retrieve the current user's account details or check API rate limit status.
- stannp_get_reporting_summary(end_date: string, start_date: string) — Tool to get a status summary on individual items within a date range. Use when you need reporting metrics for mailpieces including delivery status, printing status, and counts.
- stannp_import_recipients(file: string, group_id: string, update_existing?: boolean) — Tool to import recipients from a CSV or XLS file into a Stannp recipient group. Use when you have a mailing list file ready to upload.
- stannp_list_campaigns() — Tool to get a list of all campaigns. Use when you need to retrieve campaigns after authentication.
- stannp_list_contacts(page?: integer, limit?: integer) — Tool to list all contacts. Use when you need to retrieve contacts with optional pagination filters.
- stannp_list_folders() — Tool to get a list of folders in your secure file transfer area. Use when you need to retrieve available folders for file organization.
- stannp_list_groups(limit?: integer, offset?: integer) — Tool to get a list of mailing groups on your account. Use when you need to retrieve all groups with optional pagination.
- stannp_list_mailpieces(tag?: string, status?: string, enddate: string, startdate: string) — Tool to retrieve mailpiece objects sent within a date range. Use when you need to query mailing history with optional status or tag filters.
- stannp_list_templates(page?: integer, size?: integer) — Tool to list all templates associated with the account. Use when you need to retrieve available templates after authentication.
- stannp_merge_pdfs(files: string[]) — Tool to merge multiple PDF files into a single file. Use when you need to consolidate multiple PDFs into one document.
- stannp_purge_group(id: integer, delete_recipients?: boolean) — Tool to remove all recipients from a mailing list. Recipients remain on your account if delete_recipients is false.
- stannp_recalculate_group(group_id: integer) — Tool to recalculate a group to ensure stats are up to date. Use when you need to refresh group statistics after adding or removing recipients.
- stannp_remove_recipients_from_group(group_id: integer, recipients: string) — Tool to remove recipients from a group without deleting them. Use when you need to remove contacts from a mailing group while keeping them in your account.
- stannp_upload_file(file: object|string, folder?: integer) — Tool to upload a file to your secure file transfer area. Use when you need to upload files for direct mail campaigns. Supports both URL-based imports and binary file uploads.
- stannp_validate_address(city?: string, state?: string, company?: string, country?: string, zipcode?: string, address1?: string, address2?: string) — Tool to validate a postal address. Currently supports UK and US addresses only. Use when you need to verify if a given address is valid before sending mail.

## Example prompts
- "What can I do in Stannp?"
- "Show me a summary of my Stannp account"

## Links
Docs: https://mcp.ai/docs/mcps/stannp
Website: https://mcp.ai/mcps/stannp