# FirstQuadrant MCP MCP > FirstQuadrant MCP handles all your B2B sales prospecting actions through natural conversation. Use this to automate research, create new leads, enrich existing contacts with deep context, and manage follow-up campaigns without ever leaving your AI client. It lets you control the full lifecycle of a lead—from initial contact discovery to campaign enrollment. ## Overview - **Category:** artificial-intelligence - **Price:** Free - **Tags:** outbound-sales, lead-enrichment, prospecting, autonomous-agents, sales-pipeline, crm-integration ## Description Managing an outbound sales pipeline used to mean toggling between spreadsheets, digging through databases, and manually researching every single prospect before sending a message. Now, your agent handles it all. You simply ask for what you need. It can pull up your entire lead roster and run deep research on any contact to add company size or recent funding details automatically. Need to start a campaign? Just tell the agent who to enroll, and it sends them into the right sequence. Plus, if you ever need to check the history of interactions—emails sent, calls logged—it pulls up the full activity log instantly. Because Vinkius hosts this MCP, your AI client can access all these functions in one place, keeping your entire sales process running from a single conversation. ## Tools ### add_to_campaign Adds one or more contacts directly into an available sales sequence or email campaign. ### create_contact Creates a brand new lead or contact record in the system, initializing their profile. ### enrich_contact_ai Triggers an automated research workflow to gather external data and update a specific contact's profile. ### get_contact_details Retrieves the full, detailed information for any single contact record. ### list_activities Pulls up a chronological list of all sales activities associated with an account or contact. ### list_campaigns Shows all existing sales campaigns and sequences available for use. ### list_contacts Lists your entire database of contacts, supporting filtering by email or date range. ### list_properties_schema Displays the available custom fields and property structure used across all contact records. ## Prompt Examples **Prompt:** ``` List all qualified leads from FirstQuadrant. ``` **Response:** ``` I've retrieved your leads. You have 12 qualified contacts, including 'John Doe' (ID: 101) and 'Sarah Smith' (ID: 102). Would you like to see the interaction history for any of them? ``` **Prompt:** ``` Enrich the contact with email 'ceo@acme.com'. ``` **Response:** ``` AI enrichment triggered! I've started the research workflow for ceo@acme.com. I'll notify you as soon as the company size and latest funding details are added to the profile. ``` **Prompt:** ``` Add contact '101' to the 'Discovery Sequence'. ``` **Response:** ``` Contact enrolled! I've successfully added John Doe (ID: 101) to your 'Discovery Sequence'. They will receive the first automated email shortly. ``` ## Capabilities ### Manage Lead Rosters List and filter your contacts by specific criteria like email address or creation date. ### Generate New Leads Create a brand new lead record directly inside FirstQuadrant using just text prompts. ### Research Contacts Run autonomous research workflows to gather deep company data and update the contact profile automatically. ### Manage Outreach Campaigns Enroll contacts into predefined email sequences or campaigns instantly. ### Track Activity History Retrieve a complete log of all sales activities, including calls and emails. ## Use Cases ### Cold Prospecting Research An SDR needs to qualify 10 leads for a call. Instead of opening 10 tabs, they prompt the agent: 'Find all contacts created last week and enrich them.' The MCP uses `list_contacts` followed by multiple calls to `enrich_contact_ai`, delivering 10 fully researched profiles in one response. ### Onboarding a New Client An Account Manager just closed a deal. They tell the agent: 'Add this new contact and all their colleagues to the Q3 Discovery Sequence.' The MCP handles `create_contact` for each person, then uses `add_to_campaign` to get them into the right flow. ### Reviewing a Stalled Deal A Growth Team member needs to know why a deal stalled. They ask the agent to 'Show me all activity for John Doe.' The MCP uses `list_activities` and `get_contact_details`, showing exactly when the last email was sent and who opened it. ### Data Cleanup Audit The Ops team suspects some contact records are missing necessary fields. They ask the agent to 'List all contacts that don't have a company size listed.' The MCP uses `list_contacts` and cross-references property data using `list_properties_schema`. ## Benefits - Never manually research a prospect again. The agent can run the `enrich_contact_ai` tool to automatically gather deep context on company size and funding, updating the record instantly. - Stop wasting time toggling campaigns. You can use the MCP to enroll contacts directly using `add_to_campaign`, triggering personalized follow-ups without touching a dashboard. - Need to find a lead? Instead of guessing, you can run `list_contacts` with advanced filters (like 'created last month') and then get detailed reports on any individual record via `get_contact_details`. - Maintain perfect data hygiene. Use the MCP to confirm your property structure by calling `list_properties_schema`, ensuring all incoming sales data is properly categorized for analysis. - Track everything in one place. The agent can pull up a complete timeline of every interaction using `list_activities`, giving you full context on any account instantly. ## How It Works The bottom line is, you talk to the MCP using plain English, and it executes complex, multi-step actions in FirstQuadrant for you. 1. Subscribe to the FirstQuadrant MCP on Vinkius. 2. Grab your API Key and Organization ID from your FirstQuadrant developer settings. 3. Use your AI client's natural language interface to run commands, like asking it to list all leads or enrich a specific contact. ## Frequently Asked Questions **How do I start with FirstQuadrant MCP? Do I need to list_contacts first?** No. You don't have to call `list_contacts` manually. Just ask your agent, 'What are my top 10 leads?' The MCP will handle the listing process and present you with the results. **Can I use enrich_contact_ai to update contact fields?** Yes. That's its whole job. It triggers an automated research workflow that gathers external context (like company size) and automatically updates the relevant contact profile field. **If I create a new lead, do I have to use create_contact? Is it optional?** Yes, you must use `create_contact` if you want the record in the system. It initializes the lead and gives them an ID so the agent can track them for later campaigns. **What is the difference between list_contacts and get_contact_details?** `list_contacts` shows you a summarized view of many people (a roster). `get_contact_details` pulls up every single available piece of information for one specific person. **When I call `list_properties_schema`, what happens if my team adds a new custom field to FirstQuadrant?** You'll have to manually update the schema in your FirstQuadrant settings. The MCP reads the available fields, but it doesn't create or manage the underlying data types themselves. **If I use `add_to_campaign`, can one contact be enrolled in multiple sales sequences at once?** Yes, you can enroll a single person into several campaigns. The system tracks all associated sequence activity for that contact across every active campaign. **When listing activities using `list_activities`, how do I restrict the results to only show emails sent by our AI tools?** You must pass a specific 'activity source' parameter when calling the tool. The API supports filtering by source, letting you isolate automated tasks from manual human actions. **When I use `list_contacts`, does it automatically handle pagination for thousands of records?** No. For large datasets, always pass specific filters like date ranges or status flags to keep requests efficient and under rate limits. Pagination requires multiple calls from your agent. **How do I find my Organization ID in FirstQuadrant?** Log in to your FirstQuadrant dashboard and navigate to **Settings** > **Developer Settings**. Your unique Organization ID will be listed there. **Can the agent update custom properties?** Yes! Use the `create_contact` or `enrich_contact_ai` tools to manage standard and custom data points defined in your property schema. **How does AI enrichment work through the agent?** The `enrich_contact_ai` tool triggers FirstQuadrant's autonomous research engine to scan public sources and update the contact record with high-fidelity insights.