# leadtributor.cloud MCP

> leadtributor.cloud connects your AI client to complex channel sales operations, managing lead distribution and partner performance tracking automatically. You can orchestrate leads across large networks, monitor Service Level Agreements (SLAs), and pull high-fidelity performance metrics for every partner without manual effort.

## Overview
- **Category:** erp-operations
- **Price:** Free
- **Tags:** partner-management, lead-routing, channel-sales, sla-tracking, sales-operations, performance-analytics

## Description

This MCP takes control of how you distribute new business leads to your sales team and partner network. Instead of sending out mass emails or manually tracking acceptance rates in a dozen different spreadsheets, you talk to your AI agent. Your agent coordinates the entire process: it finds available partners, routes the correct lead based on defined rules, and logs every step taken—from initial assignment to final conversion status.

It acts as your dedicated channel coordinator. You can ask for real-time performance reports, check if a specific lead is stuck in an SLA violation, or build an audit trail showing exactly where that lead came from and who touched it. Because this MCP lives on Vinkius, you get access to 4,000+ other integrations, meaning your AI agent can coordinate leads not just through partners, but potentially across inventory systems or marketing automation tools too.

## Tools

### add_activity
Logs a specific action or event against a lead record.

### check_leadtributor_status
Verifies that the connection between your AI client and leadtributor.cloud is working correctly.

### create_lead
Adds a brand new lead record to the system.

### get_lead
Retrieves all specific details for one given lead.

### get_partner_stats
Pulls performance statistics and metrics for an entire partner account.

### get_partner
Gets detailed information about a single partner in your directory.

### list_activities
Gathers a list of all historical activities recorded across multiple leads.

### list_leads_by_partner
Filters and lists only the leads assigned to a specific partner.

### list_leads_by_status
Lists all leads that match a certain status (e.g., pending, accepted).

### list_leads
Provides a general list of all leads currently in the system.

### list_partners
Generates a list of every partner registered in your channel network.

### update_lead
Modifies the details or status of an existing lead record.

## Prompt Examples

**Prompt:** 
```
List all leads distributed to partners this week.
```

**Response:** 
```
I've retrieved your distributed leads. You currently have 10 high-fidelity records sent this week, including 7 accepted and 3 pending. Would you like the detailed partner metadata for the pending items?
```

**Prompt:** 
```
Show the conversion status for lead ID 'lead_456'.
```

**Response:** 
```
Distribution intelligence orchestrated! For lead 456, I've verified that it was accepted by 'Partner X' and is currently in the 'Contracting' stage. I've retrieved the high-fidelity activity metadata for your review. Need help notifying the manager?
```

**Prompt:** 
```
Check the performance metrics for 'Partner X'.
```

**Response:** 
```
Operational monitoring orchestrated! For Partner X, I've identified a 90% high-fidelity lead acceptance rate and 5 successful conversions this month. Your API connection is healthy. Shall I retrieve the detailed pipeline breakdown for this partner?
```

## Capabilities

### Track Lead Status
Get the current status of any lead—whether it's accepted, pending, or in conversion.

### Monitor Partner Performance
Pull detailed metrics on partner activity and overall performance to see who is hitting their goals.

### Manage Lead Records
Create new leads or update existing records with fresh information directly through natural conversation.

### View Activity History
Compile a complete log of every action taken on a lead, maintaining a perfect audit trail.

### Query Partner Details
Retrieve specific information and performance data for any partner in your network.

## Use Cases

### The end-of-quarter performance review
A Channel Manager needs a summary of all high-value leads and how many partners accepted them. Instead of pulling reports from five different dashboards, the agent executes `list_leads` followed by specific partner filtering, giving an instant overview that details conversion rates for every individual partner.

### A lead is stalled in conversion
The BD Lead sees a critical deal stuck. They ask the agent to check the status of 'lead_456'. The system pulls detailed metadata, confirming the last recorded activity and telling them exactly which partner needs a follow-up call.

### New leads need routing
A batch of 20 new leads arrives. Instead of manually assigning each one, the agent takes the list, applies the distribution rules, and uses `create_lead` for all twenty, ensuring every lead gets assigned correctly and logged immediately.

### Auditing a complex sale
Sales Ops needs to know who was responsible for touching 'lead_789'. The agent compiles the full history using `list_activities` and provides a perfect, chronological record of every touchpoint.

## Benefits

- Stop manually emailing leads to partners. Your agent handles the routing based on rules, ensuring no lead falls through the cracks.
- Monitor partner performance in real-time. Need to know if 'Partner X' is meeting their conversion goals? Ask for `get_partner_stats` and get a clean report immediately.
- Maintain perfect audit trails. Every time a lead changes hands or status updates, your agent logs the activity using `add_activity`, so you always know who did what.
- Instantly check connectivity. Use `check_leadtributor_status` to verify the API connection health before running a massive distribution job.
- Targeted reporting saves time. Instead of reviewing all leads, use `list_leads_by_partner` or `list_leads_by_status` to focus only on what matters right now.

## How It Works

The bottom line is you stop managing data and start directing your channel growth through simple conversation.

1. Subscribe to this MCP, then pull your API Key from the leadtributor.cloud dashboard.
2. Connect your AI client (Claude, Cursor, or any compatible agent) using that key.
3. Start asking for specific reports or actions—like 'List all leads pending acceptance'—and let your AI do the heavy lifting.

## Frequently Asked Questions

**How do I see all leads assigned to a specific partner using list_leads_by_partner?**
You ask the agent to run `list_leads_by_partner` and provide the partner's name or ID. It filters the massive database instantly, showing only the records relevant to that individual.

**What is the difference between list_leads and get_lead?**
The `list_leads` tool gives you a general overview of many leads. If you want all the deep details—like activity logs or specific metadata—you must use `get_lead` and provide the ID.

**Can I check if my API connection is working before running reports with check_leadtributor_status?**
Yes, using `check_leadtributor_status` verifies your connectivity. It’s a quick way to make sure the data flow won't break halfway through a major report.

**If I update a lead, how do I track that change later? (update_lead)**
After running `update_lead`, you should immediately run `list_activities`. This ensures the system logs the exact time and nature of your changes for a perfect audit trail.

**If I use the `create_lead` tool but provide invalid data, how does your MCP handle the error?**
The API responds with a detailed error payload. You'll need to inspect that payload for specific validation messages or missing required fields, which tells you exactly what needs correcting.

**When running `list_leads_by_status`, what parameters can I use to narrow down the search results?**
You can filter leads by date ranges and specific lead source types. This lets your agent focus only on 'MQL' leads or prospects created within a precise timeframe.

**What kind of information do I get when I run `list_activities` for an account?**
It provides a comprehensive audit trail, including timestamps, which user added the note, and the specific action taken. This tracks every interaction with maximum detail.

**What key metrics does the `get_partner_stats` tool aggregate for me?**
It aggregates performance indicators like conversion rate, total leads received, and average time-to-conversion. You get a clear view of their overall channel health.

**How do I find my leadtributor.cloud API Key?**
Log in to your account, navigate to **Settings** > **API**, and copy your unique access token from the credentials section.

**Can I check partner acceptance rates via AI?**
Yes! The `list_distributed_leads` tool allows your agent to retrieve high-fidelity status metadata for all leads sent to your channel network.

**How do I list my channel partners?**
Use the `list_leadtributor_partners` tool to retrieve your complete high-fidelity directory along with the unique identifiers for all managed companies.