MCP Available Tools
The Buska MCP server exposes 3 tools that AI assistants can call:
1. search_mentions
Search social mentions by keyword and platform. Equivalent to the POST /v1/mentions/search API endpoint.
| Parameter | Type | Required | Description |
|---|---|---|---|
| keyword | string | Yes | Search term |
| platform | string | No | Platform filter |
| limit | number | No | Max results (default 20) |
2. score_lead
AI-powered B2B lead qualification. Equivalent to the POST /v1/leads/score API endpoint.
| Parameter | Type | Required | Description |
|---|---|---|---|
| content | string | Yes | Text to score (min 10 chars) |
| keyword | string | No | Keyword for context |
| context | string | No | Product/service description |
3. get_signals
Retrieve qualified leads with filters. Equivalent to the GET /v1/signals API endpoint.
| Parameter | Type | Required | Description |
|---|---|---|---|
| keyword | string | No | Filter by keyword |
| intent | string | No | Filter by intent type |
| platform | string | No | Filter by platform |
| minScore | number | No | Minimum score (0-10) |
| since | string | No | ISO date filter |
| limit | number | No | Max results (default 20) |
Example usage with Claude
Once the MCP server is connected, you can ask Claude natural language questions like:
- "Search Twitter for people looking for a CRM tool and score the results"
- "Find the top 5 hot leads from LinkedIn this week"
- "Score this Reddit post for buying intent: [paste text]"
- "Get all ACTIVE signals with a score above 7 from the last 24 hours"
Practical example: multi-step AI agent workflow
Try asking Claude a complex query that chains multiple tools together:
text
Ask Claude: "Search Twitter for people looking for a CRM tool, score the top results, and show me the ones with buying intent above 70"Claude will automatically:
- Call
search_mentionswith keyword "CRM tool" on Twitter - Call
score_leadfor each result to get detailed scoring - Filter results where the score exceeds 70
- Present a summary table with the qualified leads, their scores, and reasoning
The MCP server uses the same API key and rate limits as the REST API. Each tool call counts as one API request toward your monthly quota.
Related guides
- MCP ServerSetupConfigure the Buska MCP server in Claude.ai, Claude Desktop, Cursor, or any MCP-compatible client. HTTP and stdio transport supported.
- API ReferencePOST /v1/mentions/searchSearch social media mentions on a specific platform. Returns posts with content, author, URL, engagement. Used for real-time lead scraping.
- API ReferencePOST /v1/leads/scoreScore any text or post for B2B buying intent using Buska's AI. Returns 1-10 score, intent type (ACTIVE/PAIN/COMPETITOR/QUESTION), ICP match, reasoning.