# Getprospect — how to use (mcp.ai)

Connect your Getprospect account and use 22 tools for marketing straight from your AI agent. Connect with your own API key. Find anyone's business email address. GetProspect provides email discovery and verification from LinkedIn.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_getprospect?ms=1787295840000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `getprospect_apply_coupon_code`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/getprospect`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/getprospect/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/getprospect/apply/coupon/code` — Tool to apply a coupon code to the user's account. Use after you need to activate a coupon before using it.
  - body: { coupon_code: string }
- `POST https://api.mcp.ai/api/getprospect/create/company` — Tool to create a new company. Use when you need to add a company record via GetProspect API.
  - body: { properties: object[] }
- `POST https://api.mcp.ai/api/getprospect/create/contact` — Tool to create a new contact. Use when you need a fresh contact record before associating it to lists.
  - body: { properties: object[], listRelations?: string[] }
- `POST https://api.mcp.ai/api/getprospect/create/export` — Tool to create a new export job. Use when you need to export contacts or companies based on filters or specific record IDs. Returns HTTP 201 on success.
  - body: { name: string, sort?: object, filters?: object[], itemIds?: string[], fileFormat?: string, sourceType: string, includeProperties?: string }
- `POST https://api.mcp.ai/api/getprospect/create/list` — Tool to create a new contact list. Use when you need to organize contacts into a named list.
  - body: { name: string }
- `POST https://api.mcp.ai/api/getprospect/delete/company` — Tool to delete a company record by its ID. Use when you have confirmed this company should be permanently removed.
  - body: { company_id: string }
- `POST https://api.mcp.ai/api/getprospect/delete/contact` — Tool to delete a contact record by its ID. Use when you need to remove a contact; ensure the contact ID exists before calling.
  - body: { contact_id: string }
- `POST https://api.mcp.ai/api/getprospect/delete/delete/lists` — Tool to delete multiple contact lists. Use when you have a set of list IDs and want to remove them in bulk. Use after confirming the lists to delete.
  - body: { listIds: string[], deleteContacts?: boolean }
- `POST https://api.mcp.ai/api/getprospect/get/account/workspace/limits` — Tool to retrieve workspace limits for the user's account. Use when you need to check current quotas before bulk operations.
- `POST https://api.mcp.ai/api/getprospect/get/all/companies` — Tool to retrieve all companies. Use after obtaining a valid API key. Returns a paginated list of companies for the authenticated user.
  - body: { sort?: string, order?: string, pageSize?: integer, pageNumber?: integer }
- `POST https://api.mcp.ai/api/getprospect/get/all/lists` — Tool to retrieve all prospect contact lists. Use when you need to list all existing contact lists for an account. Returns a paginated list of contact lists.
  - body: { sort?: string, order?: string, pageSize?: integer, pageNumber?: integer }
- `POST https://api.mcp.ai/api/getprospect/get/single/company` — Tool to retrieve details of a single company by its ID. Use when you have a valid company ID and need its full details.
  - body: { companyId: string }
- `POST https://api.mcp.ai/api/getprospect/get/single/contact` — Tool to retrieve details of a single contact. Use when you have the contact ID and need its full record.
  - body: { contact_id: string }
- `POST https://api.mcp.ai/api/getprospect/post/add/contacts/to/list` — Tool to add contacts to a specified list. Use when you need to group existing contacts into a list.
  - body: { list_id: string, contactsIds: string[] }
- `POST https://api.mcp.ai/api/getprospect/search/companies` — Tool to search for companies by name. Use when you have a company name and need to find matching records.
  - body: { name: string, limit?: integer }
- `POST https://api.mcp.ai/api/getprospect/search/contacts` — Tool to search for contacts by filters. Use when you need to find contacts matching specific criteria.
  - body: { sort?: string, order?: string, search?: object, filters?: object[], pageSize?: integer, pageNumber?: integer, includeRelations?: boolean }
- `POST https://api.mcp.ai/api/getprospect/search/contacts/related/to/list` — Tool to search contacts in a specific list. Use when you need to filter contacts associated with a given list.
  - body: { sort?: string, order?: string, list_id: string, pageSize?: integer, pageNumber?: integer }
- `POST https://api.mcp.ai/api/getprospect/search/through/lists/by/name` — Tool to search contact lists by name. Use when you need to find lists that match a specific name. Returns a paginated list of matching contact lists.
  - body: { name: string, sort?: string, order?: string, pageSize?: integer, pageNumber?: integer }
- `POST https://api.mcp.ai/api/getprospect/update/company` — Tool to update details of an existing company. Use when you need to modify company properties after confirming the company exists.
  - body: { companyId: string, properties: object[] }
- `POST https://api.mcp.ai/api/getprospect/update/contact` — Tool to update details of an existing contact. Use when you have the contact ID and need to modify its properties or list assignments.
  - body: { contact_id: string, properties?: object[], list_relations?: string[] }
- `POST https://api.mcp.ai/api/getprospect/update/list` — Tool to update a contact list's name. Use when you need to rename an existing list.
  - body: { name: string, list_id: string }
- `POST https://api.mcp.ai/api/getprospect/verify/email/address` — Tool to verify an email's deliverability. Use after capturing an email to ensure it's valid.
  - body: { email: string }

## Example prompts
- "What can I do in Getprospect?"
- "Show me a summary of my Getprospect account"

## More
- Page: https://mcp.ai/getprospect
- Agent spec (llms.txt): https://mcp.ai/getprospect/llms.txt
- Postman collection: https://mcp.ai/getprospect/postman.json