# PitchBox MCP > PitchBox manages influencer outreach and content marketing workflows. Use this server to list projects, track specific campaign opportunities, and monitor email conversations—all without leaving your AI agent chat window. ## Overview - **Category:** marketing-automation - **Price:** Free - **Tags:** influencer-outreach, link-building, campaign-management, lead-tracking, email-marketing, content-strategy ## Description PitchBox manages your entire influencer outreach and content marketing workflow. Connect this server to your AI client, and you’ll track everything—from initial project setup to the latest email thread—right inside the chat window. You don't have to jump between tabs or log into a separate dashboard just to get an update. **Managing Projects and Campaigns** You can start by mapping out your whole operation. Use `list_pitchbox_projects` to pull up every single project you’ve set up in PitchBox; it gives you a full rundown of what's active or maybe finished. If you want the deep dive on just one, call `get_pitchbox_project`, and you get all the specific details for that one project ID. Once you're inside a project, you can see all the campaigns running with `list_pitchbox_campaigns`. Need to know what a specific campaign is about? Use `get_pitchbox_campaign` to pull its full data set. This whole process lets your agent walk through your entire content strategy. **Tracking Opportunities and Leads** This server keeps track of every potential lead you're working with. To see all the current outreach targets, run `list_pitchbox_opportunities`, which lists every individual lead available within a specific campaign. When you spot an opportunity that needs more scrutiny, you can get its metadata using `get_pitchbox_opportunity`. This gives you everything about that single contact or lead right away. **Reviewing Communications and Contacts** The conversation is where the deal gets done. If you need to know what was said between people, use `list_pitchbox_emails` to retrieve the complete history of emails sent back and forth for a given opportunity's thread. You can also find out who you’re actually talking to; run `list_pitchbox_contacts` to view all associated contacts linked to an opportunity ID. **Checking Operational Status** You need to know what's going on with the account itself, too. Use `list_pitchbox_tasks` if you want a full list of every active or pending task across your entire PitchBox account. Need to check your own profile info? `get_pitchbox_me` pulls and returns your current user data directly from PitchBox. This server makes sure all your core operational details are always within reach, keeping your outreach pipeline moving without any fuss. ## Tools ### get_pitchbox_campaign Retrieves the full details for a single, specified PitchBox campaign. ### get_pitchbox_me Pulls and returns your current user profile information from PitchBox. ### get_pitchbox_opportunity Gets the specific metadata for one individual outreach opportunity (lead). ### get_pitchbox_project Retrieves all details for a single PitchBox project. ### list_pitchbox_campaigns Lists every campaign currently running inside a specific project. ### list_pitchbox_contacts Lists all contacts associated with a particular outreach opportunity ID. ### list_pitchbox_emails Retrieves the full list of emails sent and received for an opportunity's thread. ### list_pitchbox_opportunities Lists all outreach leads available within a specific campaign. ### list_pitchbox_projects Returns a comprehensive list of every project you have set up in PitchBox. ### list_pitchbox_tasks Shows all active, pending tasks assigned across your entire PitchBox account. ## Prompt Examples **Prompt:** ``` List all active campaigns in my 'Guest Posting' project. ``` **Response:** ``` I've retrieved your campaigns. In the 'Guest Posting' project, you have 4 active ones: 'Tech Blogs Q4', 'Lifestyle Outlets', 'Marketing Insights', and 'Industry News'. ``` **Prompt:** ``` Show me the status of the link-building opportunity for 'example.com'. ``` **Response:** ``` The opportunity for 'example.com' (ID: 98765) is currently in the 'Replied' stage. A follow-up email was sent 2 days ago. Would you like to see the last email message? ``` **Prompt:** ``` What outreach tasks are assigned to me for today? ``` **Response:** ``` You have 5 tasks for today: 'Review pitches for Campaign 123', 'Verify contact for Opp 456', and 3 personalization tasks. Would you like to start with the reviews? ``` ## Capabilities ### List and get project details View a full catalog of PitchBox projects, or pull specific data for one project ID. ### Manage campaigns and leads Get all active campaigns within a project, or list every individual outreach opportunity (lead) in a campaign. ### Review communications and contacts List the contact details for an opportunity, or retrieve the complete history of emails sent to that opportunity. ### Check operational status Access your current user profile info or pull a list of all active tasks across your account. ## Use Cases ### Need to audit all recent comms on a lead. A client asks about 'example.com'. Instead of going into the Opportunity dashboard, you prompt your agent with: 'Show me emails for example.com.' The agent runs `get_pitchbox_opportunity` and then `list_pitchbox_emails`, giving you the full, chronological thread instantly. ### Want to check tasks across all campaigns. You start your day by asking: 'What outreach tasks do I have today?' The agent runs `list_pitchbox_tasks` and gives you a prioritized list of pending actions, letting you know exactly where to focus your time. ### Need to see if an opportunity is viable. You pull a new lead ID. You ask the agent to check its status using `get_pitchbox_opportunity`. The tool returns detailed metadata, telling you immediately if it's in the 'Initial Contact' stage or if follow-up emails are needed. ### Building a report on project scope. You need to prove how many campaigns belong under your 'Q4 Growth' initiative. You prompt: 'List all campaigns in the Q4 Growth project.' The agent runs `list_pitchbox_campaigns` and provides the full list, confirming the scope of work. ## Benefits - See every lead's status without leaving the chat. Use `list_pitchbox_opportunities` to get a snapshot of all contacts in a campaign instantly. - Review full communication history immediately. Calling `list_pitchbox_emails` pulls every sent and received message for an opportunity, saving you from switching tabs. - Get project oversight at a glance. Use `list_pitchbox_projects` to see your entire portfolio of work, then use `get_pitchbox_campaign` on the specific one you need. - Know who's involved and what needs doing. You can pull contacts with `list_pitchbox_contacts` or check your daily workload using `list_pitchbox_tasks`—all in one prompt. - Reduce data retrieval time by 90%. Instead of navigating Project > Campaign > Opportunity, you just ask for the status using `get_pitchbox_opportunity`. ## How It Works The bottom line is: You talk to your AI client like talking to a teammate who already has access to all your campaign dashboards. 1. Subscribe to the server and enter your PitchBox API Key in the settings. 2. Tell your agent what you need (e.g., 'List campaigns for my biggest project'). 3. The agent runs the appropriate tool, pulls the data, and presents it back to you directly in the chat. ## Frequently Asked Questions **How do I list campaigns using list_pitchbox_campaigns?** You must provide a Project ID or name first. The agent uses that context to run `list_pitchbox_campaigns`, giving you every campaign active under the scope of that single project. **Does get_pitchbox_opportunity require an Opportunity ID?** Yes, absolutely. This tool needs a specific opportunity ID to run. It can't guess which lead you mean; it requires precise input to fetch the correct metadata. **Can I see contacts for all leads at once?** No. The `list_pitchbox_contacts` tool is scoped to a single opportunity ID. You'll need to first run `list_pitchbox_opportunities`, identify the IDs you want, and then ask for contacts for each one. **What if I don't know my Project ID?** First, you have to use the `list_pitchbox_projects` tool. This will return a list of all your projects and their associated IDs. Once you have that, you can proceed with listing campaigns. **What should I do if my API key is invalid when running get_pitchbox_me?** The system will return a specific authentication error code, usually 401. You need to re-verify the API key in your PitchBox account settings and ensure it hasn't expired or been revoked. **If I use list_pitchbox_opportunities on an empty campaign, does the tool fail?** No, the tool handles it fine. It won't throw an error; instead, it returns a clean list with zero records and confirms that no opportunities were found for that specific campaign ID. **When calling list_pitchbox_emails, how do I handle pagination or rate limits?** The tool supports standard cursor-based pagination. If you hit a limit, the API response includes a `next_cursor`. You must pass that cursor in your subsequent call to continue fetching messages. **Does list_pitchbox_projects return all available metadata for the project, or just a summary?** It returns essential metadata needed to identify and organize your projects. You get the Project ID, name, creation date, and status—enough info to plan subsequent actions. **How do I find my PitchBox API Key?** Log in to your PitchBox account, click on your name in the top right, go to **Settings** > **API**. There you can find and copy your unique API Key. **Can I see all emails exchanged with a lead?** Yes! Use the `list_pitchbox_emails` tool with an Opportunity ID to retrieve a full history of outbound and inbound messages for that specific lead. **Does this support looking up individual contacts?** Absolutely. Use the `list_pitchbox_contacts` tool to retrieve all identified contact names and information associated with a particular outreach opportunity.