# ChurchStamp MCP MCP > ChurchStamp MCP manages physical direct mail campaigns for ministries and churches. Use this connector to automate postcard outreach, track mailing status in real-time, manage contact lists, and coordinate campaign design through natural conversation with your AI client. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** direct-mail, postcard-marketing, automated-outreach, church-management, donor-engagement, physical-mail ## Description You can use your AI agent to run the entire lifecycle of a church's physical communication program without lifting a finger. Instead of manually uploading spreadsheets or logging into multiple portals to check statuses, you simply ask your agent what needs mailing. It handles everything from listing available designs and verifying contact data to launching complex campaigns. Your agent acts as a dedicated mail coordinator. You can list all active campaign portfolios, retrieve performance metrics for specific outreach efforts, and programmatically send personalized postcards or letters. This automation gives you full control over your direct marketing without the usual back-and-forth with manual forms. It’s how Vinkius helps you take physical outreach from a complicated chore to a simple conversation. ## Tools ### check_churchstamp_status Verifies that the connection to ChurchStamp is active and working correctly. ### create_campaign Sets up a new mail campaign, optionally assigning it a specific design template. ### create_contact Adds a brand-new member or donor contact to the system directory. ### get_campaign Retrieves detailed information about a specific, existing mail campaign. ### get_design Fetches technical details and specifications for a specific postcard design. ### get_user_details Retrieves basic information about the connected user account. ### list_campaigns Gets a list of all current and past mail campaigns run through ChurchStamp. ### list_contacts Provides a comprehensive directory listing of all stored contacts in the system. ### list_designs Shows every available postcard and letter template design for use. ### send_mail Triggers the physical mailing of a personalized postcard or letter to one or more recipients. ## Prompt Examples **Prompt:** ``` Send a 'Welcome Postcard' (Design ID: ds_123) to 'John Doe' at '123 Main St, London, SW1A 1AA'. ``` **Response:** ``` Mail orchestrated! I've successfully triggered the sending of your 'Welcome Postcard' to John Doe. The transmission ID is mail_987. Shall I notify you once the delivery status is confirmed? ``` **Prompt:** ``` List all active direct mail campaigns in my ChurchStamp account. ``` **Response:** ``` Campaign directory orchestrated! You currently have 5 active portfolios, including 'Christmas Outreach' and 'New Member Welcome'. Would you like the detailed performance metadata for any of them? ``` **Prompt:** ``` Show my available mail designs and templates. ``` **Response:** ``` Design architecture orchestrated! I've identified 3 mail designs, including 'Modern Postcard' and 'Standard Letter'. I've retrieved the technical metadata for your next campaign. Need help selecting a design for a new recipient? ``` ## Capabilities ### Initiate Mailings Send personalized postcards and letters to specific contacts using defined designs. ### Manage Campaigns View, list, and retrieve performance details for all active direct mail campaigns. ### Handle Contacts Add new members to the directory or pull comprehensive lists of existing contacts. ### Coordinate Designs Browse and retrieve technical details for all available postcard templates and design assets. ### Monitor Operations Check the real-time delivery status of sent mail pieces or verify API connectivity for service uptime. ## Use Cases ### Welcome Back Campaign A volunteer needs to send welcome postcards to 50 members. Instead of manually pulling the list and designing each piece, they tell their agent: 'Send a Welcome Postcard (Design ID: ds_123) to all contacts who joined last month.' The agent uses `list_contacts` and then `send_mail`. ### Reviewing Last Quarter's Efforts The marketing manager needs to see how the 'Christmas Outreach' campaign performed. They ask their agent, which first calls `list_campaigns`, then uses `get_campaign` to retrieve all performance metadata for detailed reporting. ### Updating a Key Donor A donor moved and the address needs updating. Instead of logging into the contact management system, they ask their agent to use `create_contact` (or update existing records) with the new mailing details immediately. ### Auditing Designs The design team can quickly review all available templates by calling `list_designs`, confirming if a required card type is already built before starting a new project. ## Benefits - You don't have to manually upload CSVs anymore. Simply ask your agent to run a campaign, and it handles the recipient list assignment through `send_mail`. - Never guess if your connection is working again. Use `check_churchstamp_status` at any time to verify API connectivity before running critical mailings. - Keep everything coordinated by using `list_designs`. This lets you see all available templates and ensure the brand look is consistent across every outreach piece. - Need performance data? You can ask your agent to list campaigns (`list_campaigns`) and then drill down with `get_campaign` for detailed results on any portfolio. - Adding new people is simple. Use `create_contact` to instantly add a member, or pull the whole roster using `list_contacts`, all via natural language. ## How It Works The bottom line is: your AI client manages the entire flow of information and action, turning complex backend processes into simple chat commands. 1. First, connect your AI client and retrieve your Access Token from your ChurchStamp dashboard settings. 2. Next, use natural language commands to list campaigns or contacts; the agent pulls the necessary data into the conversation context. 3. Finally, tell the agent exactly what you want—for example, 'Send a welcome postcard to John Doe'—and it triggers the physical mail process. ## Frequently Asked Questions **How do I check if ChurchStamp MCP is connected?** Run `check_churchstamp_status`. This tool verifies your API connectivity and tells you immediately if the service is ready for mailings or if there’s an issue with your credentials. **What tools can I use to find available designs?** Use `list_designs` to see a comprehensive list of every postcard template. If you know the design ID, you can also use `get_design` for full technical specs. **How do I send mail using the ChurchStamp MCP?** You trigger it with `send_mail`. To make it work, you'll first need to have a campaign running, so consider calling `create_campaign` beforehand. **Can I list all contacts in the ChurchStamp MCP?** Yes. Simply call `list_contacts` and the agent will give you the full directory of every person recorded in your system. **What parameters does the `create_campaign` tool need to run a new mailing campaign?** It requires defining the general scope and linking it to an available design template. You must specify whether this is a welcome, annual giving, or outreach mail piece. The system then handles assigning tracking IDs and preparing the metadata for execution. **When using the `create_contact` tool, how does it handle incomplete or incorrectly formatted recipient data?** The tool validates required fields like names and physical addresses before accepting a record. If data is missing crucial information—for example, an invalid ZIP code—the API returns an explicit validation error code that tells you exactly what needs fixing. **How do I get detailed performance metrics by running the `get_campaign` tool?** You simply provide the specific Campaign ID to retrieve comprehensive details. This report includes sending history, total volume processed, and any recorded delivery statuses for that campaign's timeline. **Using `get_user_details`, what information can I access about my ChurchStamp account security and limits?** This tool pulls general account metadata. You can check your current mailing volume thresholds or verify associated user profile data directly through the query. This is useful for planning large outreach efforts. **How do I find my ChurchStamp Access Token?** Log in to your account, navigate to **Settings** > **Security**, and copy your unique Access Token from the API section. **Can I send personalized postcards via AI?** Yes! The `send_churchstamp_mail` tool allows your agent to trigger physical mailings by providing recipient metadata and design IDs. **How do I list my mail designs?** Use the `list_designs` tool to retrieve your complete directory along with the unique identifiers for all managed templates.