kolvera-mcp

# Kolvera MCP Server

**Australian sales intelligence & BD platform for recruiters — 102 tools via MCP.**

Search Australian companies (ASIC, ABR, SEEK, trades directories), enrich contacts with verified email and direct-dial phone (+61 validated), run multi-step AI outreach campaigns, trigger deep research that maps markets to your Ideal Client Profile, and manage your full pipeline — all from Claude, Cursor, Codex, or any MCP client.

## Quick Start

### Claude Desktop / Claude Code

Add to your MCP config:

```json
{
  "mcpServers": {
    "kolvera": {
      "type": "streamable-http",
      "url": "https://mcp.kolvera.io/mcp"
    }
  }
}
```

OAuth will prompt you to log in and authorise on first use. [Sign up free](https://www.kolvera.io/auth/register) (50 credits, no card required).

### Cursor / Codex / Any MCP Client

Use the streamable-http endpoint:

```
https://mcp.kolvera.io/mcp
```

Authentication: OAuth 2.0 with Dynamic Client Registration (RFC 7591). No API key setup needed — your MCP client handles the flow automatically.

## What You Can Do

| Category | Tools | Examples |
|----------|-------|---------|
| **Contacts** | 5 | Search, create, update, delete contacts |
| **Companies** | 7 | Search Australian companies, research hiring signals |
| **Enrichment** | 11 | Find email (2cr), find phone (2-6cr), bulk enrich, verify |
| **Campaigns** | 16 | Create multi-step email sequences, generate AI copy, enrol contacts |
| **Pipeline** | 2 | Search scraped job listings with tokenised queries |
| **Scraping** | 9 | Scrape SEEK/Indeed/LinkedIn/Reed, manage search configs |
| **Deep Research** | 4 | AI market research mapping companies to your ICP (3cr) |
| **Hot Lists** | 9 | Build tiered prospect/candidate lists, auto-score |
| **ICP** | 13 | Create/generate Ideal Client Profiles, link companies + prospects |
| **MPC** | 6 | Most Placeable Candidate profiles for recruiters |
| **Meetings** | 7 | Schedule, sync Fathom summaries, match to contacts |
| **Credits** | 2 | Check balance, view transaction history |
| **Business Context** | 5 | Define your agency for AI-generated messaging |

## Example Prompts

**Find and enrich decision-makers:**
> "Search for IT recruitment agencies in Sydney with 10-50 employees, then find email and phone for the directors at the top 5 results."

**Launch a campaign:**
> "Create a 3-step email campaign targeting my hot list 'Sydney IT Directors' — intro, case study follow-up, and meeting request. Space steps 3 days apart."

**Deep-research a market:**
> "Run deep research on the aged care recruitment market in Melbourne — who are the key players, what's the hiring volume, and which companies fit my ICP?"

## Australian Data Moat

Kolvera's unique value is **Australian-first data sources** that global competitors don't have:

- **ASIC** — Australian Securities & Investments Commission company registry
- **ABR** — Australian Business Register (ABN/ACN lookup)
- **SEEK** — Australia's largest job board (hiring signal extraction)
- **AU trades directories** — niche industry sources
- **+61 phone validation** — rejects toll-free/wrong-country numbers

All enrichment runs against your Kolvera tenant using your existing plan credits.

## Pricing

Free trial: 50 credits (no card). Paid plans from A$69/mo (Starter, 750 credits).

Credit costs: email enrichment 2cr/contact, phone 2-6cr, deep research 3cr, company search 2cr. Full breakdown at [kolvera.io/guide/credits](https://www.kolvera.io/guide/credits).

## Auth & Transport

| Property | Value |
|----------|-------|
| Transport | Streamable HTTP |
| Endpoint | `https://mcp.kolvera.io/mcp` |
| Auth | OAuth 2.0 (Dynamic Client Registration) |
| Scopes | Per-domain (contacts, companies, campaigns, etc.) |
| Privacy Policy | [kolvera.io/privacy](https://www.kolvera.io/privacy) |
| Status | Production (GA) |

## Full Tool List (102)

<details>
<summary>Click to expand all 102 tools</summary>

### Contacts (5)
| Tool | Description |
|------|-------------|
| `search_contacts` | Search contacts by name, title, email, or company |
| `get_contact` | Get full details for a contact |
| `create_contact` | Create a contact, auto-linking company |
| `update_contact` | Update contact fields |
| `delete_contact` | Delete a contact and clean up references |

### Companies (7)
| Tool | Description |
|------|-------------|
| `search_companies` | Search by name, domain, industry, or location |
| `get_company` | Get company details with contact count |
| `get_company_contacts` | List all contacts at a company |
| `create_company` | Create a company (deduplicates by name) |
| `update_company` | Update company fields |
| `delete_company` | Delete company and all dependents |
| `research_company` | AI research on hiring signals (1cr) |

### Enrichment (11)
| Tool | Description |
|------|-------------|
| `find_contact_email` | Multi-provider waterfall email enrichment (2cr) |
| `find_contact_phone` | Waterfall phone enrichment (2-6cr) |
| `verify_contact_email` | Verify email via MillionVerifier (free) |
| `bulk_find_emails` | Bulk email enrichment (async, 2cr each) |
| `bulk_find_phones` | Bulk phone enrichment (async) |
| `get_bulk_enrichment_status` | Check bulk enrichment progress |
| `get_enrichment_job` | Poll async enrichment job |
| `find_company_contacts` | Find decision-makers at a company (2cr/contact) |
| `find_company_candidates` | Find candidates via LinkedIn (recruitment only) |
| `batch_find_contacts` | Find contacts at up to 20 companies |
| `batch_find_candidates` | Find candidates at up to 10 companies |

### Campaigns (16)
| Tool | Description |
|------|-------------|
| `list_campaigns` | List campaigns with stats |
| `get_campaign` | Get campaign details + steps |
| `get_campaign_stats` | Performance metrics and per-variant stats |
| `create_campaign` | Create a draft campaign |
| `update_campaign` | Update campaign settings |
| `duplicate_campaign` | Clone a campaign |
| `activate_campaign` | Start sending |
| `pause_campaign` | Pause sends |
| `resume_campaign` | Resume sends |
| `delete_campaign` | Delete campaign and all data |
| `enrol_contacts_in_campaign` | Enrol contacts (skips DNC) |
| `unenrol_from_campaign` | Remove contacts |
| `get_campaign_enrollments` | List enrolled contacts + status |
| `create_campaign_step` | Add an email step |
| `update_campaign_step` | Edit step subject/body/delay |
| `delete_campaign_step` | Remove a step (auto-renumbers) |
| `generate_campaign_steps` | AI-generate email steps (async) |
| `get_campaign_generation_status` | Check generation complete |
| `list_inboxes` | List connected sending inboxes |
| `assign_inbox_to_campaign` | Assign inbox for sending |

### Pipeline (2)
| Tool | Description |
|------|-------------|
| `search_pipeline_jobs` | Search job listings with tokenised queries |
| `get_pipeline_job` | Get full job listing details |

### Scraping (9)
| Tool | Description |
|------|-------------|
| `run_job_scrape` | Scrape SEEK/Indeed/LinkedIn/Reed (async) |
| `run_saved_config` | Run an existing search config |
| `get_scrape_progress` | Check scrape progress |
| `list_scrape_configs` | List saved search presets |
| `get_scrape_config` | Get config details |
| `update_scrape_config` | Update config settings |
| `archive_scrape_config` | Soft-delete a config |
| `delete_scrape_config` | Permanently delete a config |
| `analyze_scrape_quality` | Quality gate stats for recent scrapes |
| `update_search_config_excludes` | Add to exclude lists |

### Deep Research (4)
| Tool | Description |
|------|-------------|
| `trigger_deep_research` | AI market research (3cr) |
| `expand_deep_research` | Expand existing report (2cr) |
| `get_research_report` | Get research results |
| `list_research_reports` | List all reports |

### Hot Lists (9)
| Tool | Description |
|------|-------------|
| `list_hot_lists` | List curated collections |
| `get_hot_list` | Get list with members |
| `create_hot_list` | Create (contacts/prospects/candidates) |
| `update_hot_list` | Rename or update description |
| `delete_hot_list` | Delete list (members kept) |
| `add_to_hot_list` | Add members with tier/status/notes |
| `remove_from_hot_list` | Remove members |
| `update_hot_list_member` | Update tier/status/notes |
| `build_target_hotlist` | Auto-score and rank into S/A/B tiers |

### ICP (13)
| Tool | Description |
|------|-------------|
| `list_icp_profiles` | List Ideal Client Profiles |
| `get_icp_profile` | Get ICP with company map |
| `list_icp_prospects` | List linked prospects |
| `list_profile_suggestions` | Pending suggestions from calls |
| `create_icp_profile` | Create ICP manually |
| `generate_icp_profile` | AI-generate ICP from description (2cr) |
| `update_icp_profile` | Update ICP fields |
| `archive_icp_profile` | Soft-delete ICP |
| `delete_icp_profile` | Permanently delete |
| `link_prospect_to_icp` | Link a prospect |
| `unlink_prospect_from_icp` | Unlink a prospect |
| `link_company_to_icp` | Link company to map |
| `unlink_company_from_icp` | Remove from map |

### MPC Profiles (6)
| Tool | Description |
|------|-------------|
| `list_mpc_profiles` | List Most Placeable Candidate profiles |
| `get_mpc_profile` | Get MPC with company map |
| `create_mpc_profile` | Create MPC manually |
| `update_mpc_profile` | Update MPC fields |
| `delete_mpc_profile` | Permanently delete |
| `generate_mpc_profile` | AI-generate from role title (1cr) |

### Meetings (7)
| Tool | Description |
|------|-------------|
| `list_meetings` | List meetings (filterable) |
| `get_meeting` | Get meeting with contact info |
| `create_meeting` | Create with ISO 8601 start |
| `update_meeting` | Update details |
| `delete_meeting` | Delete meeting |
| `sync_fathom_meetings` | Pull Fathom summaries |
| `list_fathom_notes` | List AI meeting summaries |

### Credits (2)
| Tool | Description |
|------|-------------|
| `get_credit_balance` | Check plan + addon balance |
| `get_credit_history` | Transaction history |

### Bus