# Boostapp MCP MCP

> Boostapp automates your lead management workflow, letting you capture and organize customer data directly from any AI agent. It handles everything from creating new leads with full names and phone numbers to automatically assigning them the correct pipeline stage. Stop manual entry; start managing your entire sales funnel through natural conversation.

## Overview
- **Category:** sales-automation
- **Price:** Free
- **Tags:** crm, lead-management, sales-pipeline, customer-acquisition, automation

## Description

Connecting Boostapp via Vinkius lets your AI client act like a virtual salesperson for your CRM. Instead of copying and pasting data, you talk to your agent, and it handles the rest. Your AI captures lead information—full names, phone numbers, emails, birth dates—and organizes it straight into Boostapp. It doesn't just dump data; it figures out where that lead belongs in your sales pipeline and attaches any necessary subscription details automatically. This means you keep your customer database clean and organized without ever touching the Boostapp UI yourself.

## Tools

### create_lead
Registers a new lead in Boostapp; requires full name and phone number. It can also assign a pipeline stage or link subscription details.

## Prompt Examples

**Prompt:** 
```
Create a new lead for John Smith with phone 0501234567 and email john@example.com.
```

**Response:** 
```
I've successfully created the lead for John Smith in Boostapp. The contact is now registered with the provided phone and email.
```

**Prompt:** 
```
Add a lead named Sarah Connor, phone 0549876543, and set her pipeline stage to 2.
```

**Response:** 
```
Sarah Connor has been added to Boostapp and assigned to pipeline stage 2.
```

**Prompt:** 
```
Register a lead for Mike Ross (0521112233) with the remark 'Interested in the annual subscription' and item ID 101.
```

**Response:** 
```
Done! Mike Ross is now in the system with the note about the annual subscription and linked to item 101.
```

## Capabilities

### New Lead Registration
The MCP creates a brand new contact record within Boostapp using provided names and phone numbers.

### Pipeline Staging
It automatically assigns the newly created lead to a specific stage in your sales pipeline, tracking where they are in the funnel.

### Detailed Profile Capture
You can add deep details to a record, including email addresses, gender, birth dates, and custom notes.

### Subscription Linking
When creating the lead, it links that contact directly to specific products or subscription items for tracking.

## Use Cases

### The SDR needs to quickly log a chat conversation.
An SDR just finished talking with a prospect. Instead of making notes in an external document, they ask their agent: 'Log John Smith (0521112233) and mark him as interested in the annual subscription.' The agent uses `create_lead` to get all that info logged right into Boostapp.

### Marketing needs to ingest a list of leads from an ad campaign.
A marketing manager provides 10 new lead details via email. Instead of having a team member manually enter them one by one, the agent processes the batch data and uses `create_lead` for every contact, assigning them all to 'New Prospect' stage.

### The founder needs to track product interest during discovery calls.
During a call, the owner learns a prospect is interested in Item ID 101. They prompt their agent: 'Log this lead and make sure it's linked to item 101.' The MCP uses `create_lead` to ensure both contact data and product interest are recorded.

### The sales team needs to update a lead's status after follow-up.
A lead moves from 'Initial Contact' to 'Needs Demo'. Instead of opening Boostapp and changing the stage, the agent simply updates their status using `create_lead` parameters, keeping the process conversational.

## Benefits

- Capture data instantly. Instead of pausing a call to open Boostapp and manually enter a name or number, simply tell your agent the details. The `create_lead` tool handles the whole thing in one go.
- Automate stage tracking. When you register a lead, the MCP assigns them to a specific pipeline status. This means marketing doesn't have to wait for someone to remember to update the CRM manually.
- Deep data capture. The agent can pull more than just names; it captures emails, birth dates, and custom remarks into the record when using `create_lead`.
- Product linking built-in. You don't just create a contact; you link them directly to specific items or subscription plans right from your chat window.
- Saves time across teams. Marketing managers can ensure leads coming from multiple sources all hit the CRM correctly, without anyone needing to copy and paste data into different tabs.

## How It Works

The bottom line is that your AI client translates conversational input into actionable CRM records instantly.

1. Subscribe to this MCP and input your Boostapp API Key.
2. Your AI agent receives a natural language prompt containing lead details (names, phone numbers, notes).
3. The MCP processes the data using the `create_lead` tool and registers the complete record inside Boostapp.

## Frequently Asked Questions

**How does Boostapp MCP use the create_lead tool?**
The `create_lead` tool uses your AI client's natural language input to construct a new, fully detailed lead record in Boostapp. It makes sure all required fields like name and phone number are present.

**Does create_lead only handle basic contact info?**
No. While it requires the full name and phone number to function, you can also include optional details like setting a specific pipeline stage or linking subscription items during the creation process.

**What if I don't provide a phone number for create_lead?**
The `create_lead` tool requires both a full name and a phone number to execute successfully. Make sure your prompt includes both pieces of information for the lead record.

**Can I use Boostapp MCP to update an existing lead's stage?**
This specific tool, `create_lead`, focuses on creating new records. However, it can also add crucial details or link subscriptions when a lead is first registered.

**What credentials do I need to authorize `create_lead` calls?**
You must provide a valid Boostapp API key. This key authenticates your agent's requests, giving it the specific permissions needed to write new records into your system.

**Does `create_lead` allow me to update existing lead information?**
No. The current functionality of this MCP is limited strictly to creating brand-new leads. You'll need a different tool or method if you want your agent to modify an entry that already exists.

**What happens if the data provided to `create_lead` has missing optional fields?**
The process completes normally. The tool only requires a full name and phone number; all other details like pipeline stages or custom remarks are simply omitted from the new lead record.

**Are there any limits on how often I can call `create_lead`?**
Yes, Boostapp enforces standard API rate limits. If your agent makes too many calls in a short time, you'll receive an error code that tells you when to wait before trying the creation again.

**What information is mandatory to create a lead in Boostapp?**
To create a lead using the `create_lead` tool, you must provide at least the `fullName` and a valid `phone` number. All other fields like email or pipeline stage are optional.

**Can I assign a lead to a specific sales stage automatically?**
Yes! When using `create_lead`, you can provide a `stage` ID (number) to place the lead directly into the correct part of your sales pipeline.

**Is it possible to record the source of the lead?**
Absolutely. Use the `leadSource` parameter in the `create_lead` tool to specify the system ID of the marketing or sales source.