Servidor MCP

YourICP

com.youricp/mcp-server
Marketing y publicidad Ventas y CRM Público y accesible MCP 2025-11-25

Qué hace este MCP

Enriches contacts from email or LinkedIn URLs and builds targeted B2B audiences with filtering, previews, contact pulls, and downloadable lists.

activate_login
Activate a login completed in the browser. Call this after signing in at the login page. Automatically retrieves the auth token and activates it for this session — no copy/paste needed.
Solo lectura
Esquema de entrada
{'type': 'object', 'properties': {}}
audience_download_run
Get the download link for a completed audience run. Returns a presigned URL the user can click to download their contact list. RENDERING — MANDATORY, VERBATIM: The response contains a download link already formatted as a markdown link with an angle-bracket destination: [Download ...](<https://...>). Present it exactly as returned. Keep the angle brackets around the URL, do NOT percent-encode or decode any query parameters, and do NOT drop, reorder, or truncate any parameter — every response-content-* and X-Amz-* param must be preserved byte-for-byte. Do NOT rewrite it into a code block, a bare URL, or an HTML anchor; emit the markdown link as the backend sent it.
Solo lectura
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['runId'], 'properties': {'runId': {'type': 'string', 'description': 'The runId returned by audience_start_run or check_payment'}}}
audience_get_filters
Fetch all available audience filter categories as an interactive filter picker. Only call this after audience_start has been called and the user chose Option B (interactive filter picker). Do not call this tool to guess or pre-populate filters on behalf of the user. RENDERING — MANDATORY, VERBATIM: The response is usually a complete HTML document. Pass the returned HTML string unchanged to the visualizer/render tool. Do NOT rebuild, restyle, summarize, trim, or hand-author a replacement UI. If the response is plain text instead of an HTML document (this happens on clients that cannot render HTML), simply present that text to the user as-is and let them pick filter values by name — do not look for a visualizer. Render EVERY tab and EVERY chip exactly as received, in the order received, using the exact data-cat and data-val attributes the backend emitted. This includes tabs whose chip list is empty — render the empty tab as-is, do NOT drop it and do NOT invent or backfill chips for it. ALWAYS keep the "Get estimation" button (id="getEstBtn") in the rendered widget. It is the action control the user clicks to run the preview — never remove, hide, rename, or replace it. Do NOT move a chip from the tab/category the backend placed it in. If a value arrives under data-cat="industries", it is rendered and reported under industries — the client must not re-route it to seniority, departments, buying_roles, employee_size, or revenue based on its label. Field placement is the backend's responsibility, not the client's. When the user makes selections, resolve names→keys ONLY via the <script id="filter-key-map"> JSON in the returned HTML, then call audience_preview with those exact keys.
Solo lectura
Esquema de entrada
{'type': 'object', 'properties': {}}
audience_preview
Preview audience size from explicit filter selections made by the user in the filter picker UI. IMPORTANT: Only call this after audience_get_filters has been shown and the user has made their own selections. Never infer or pre-fill filter values — only pass values the user explicitly selected. If the user has not yet seen the filter picker, call audience_start then audience_get_filters first.
Solo lectura
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'regions': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Region/state names'}, 'revenue': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Revenue range keys'}, 'countries': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Country names'}, 'seniority': {'type': 'array', 'items': {'type': 'string'}, 'description': "Seniority level keys (e.g., 'junior', 'senior')"}, 'industries': {'type': 'array', 'items': {'type': 'string'}, 'description': "Industry keys (e.g., 'software')"}, 'departments': {'type': 'array', 'items': {'type': 'string'}, 'description': "Department/job function names (e.g., 'Customer Service')"}, 'buying_roles': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Buying role keys'}, 'employee_size': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Employee size keys'}}}
audience_quick_preview
Preview audience size from a free-text description the user provided in this conversation. IMPORTANT: Only call this after audience_start has been called and the user has described their target audience in their own words (Option A). Never pre-select or assume filter values — only use criteria the user explicitly stated. If the user has not yet described their audience, call audience_start first.
Solo lectura
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['description'], 'properties': {'regions': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Region/state names'}, 'revenue': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Revenue range keys'}, 'countries': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Country names'}, 'seniority': {'type': 'array', 'items': {'type': 'string'}, 'description': "Seniority level keys (e.g., 'junior', 'senior')"}, 'industries': {'type': 'array', 'items': {'type': 'string'}, 'description': "Industry keys (e.g., 'software')"}, 'departments': {'type': 'array', 'items': {'type': 'string'}, 'description': "Department/job function names (e.g., 'Customer Service')"}, 'description': {'type': 'string', 'description': "The user's audience description or criteria (for logging)"}, 'buying_roles': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Buying role keys'}, 'employee_size': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Employee size keys'}}}
audience_start
Entry point for all audience-building workflows. Always call this first when the user wants to find contacts, build an audience, or get a contact list. This tool decides which options to offer based on the connected client: clients that can render the interactive filter widget (e.g. Claude) are offered both (A) describe their target in free text and (B) pick filters interactively; other clients are offered free text only. Present EXACTLY the options contained in this tool's response and nothing more — in particular, do not offer or mention the interactive filter picker unless the response includes it. Do not call audience_quick_preview, audience_preview, or audience_get_filters without calling this tool first.
Solo lectura
Esquema de entrada
{'type': 'object', 'properties': {}}
audience_start_run
Start a contact pull run for a built audience. Requires audienceId from the build step and totalContacts from preview. If logged in, the run is charged to the account's YourICP billing-token balance (29 billing tokens per contact, where 100 billing tokens = $1.00) and returns a runId — call audience_download_run immediately after. Call check_billing_balance first if you want to tell the user the cost before spending. If the balance is short, this returns error "mcp_insufficient_tokens" with required, available and shortfall counts — tell the user exactly how many tokens to top up at app.youricp.com and do NOT retry until they have. If it returns "mcp_no_billing_account", the client is not linked to an account yet and only support can fix it — do NOT retry. If not logged in, card payment is required instead (capped at $1,000) — this tool returns a checkoutUrl and sessionId, then call check_payment, then audience_download_run with the runId.
Destructivo
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['audienceId', 'totalContacts'], 'properties': {'audienceId': {'type': 'string', 'description': 'The audience id returned by the build step'}, 'totalContacts': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'total_contacts value from the preview result', 'exclusiveMinimum': 0}}}
check_billing_balance
Read the YourICP BILLING TOKEN balance this account's runs are charged against. Billing tokens are YourICP's prepaid currency: 100 billing tokens = $1.00, and an audience contact costs 29 billing tokens. They are NOT the auth token — that is the API credential set by set_auth_token. Call this before audience_start_run when the user asks what a run will cost, or after an "mcp_insufficient_tokens" error to confirm the balance. Requires the user to be logged in.
Solo lectura
Esquema de entrada
{'type': 'object', 'properties': {}}
check_lookup
Check the result of a previously submitted contact enrichment job by jobId. Polls every 5 seconds until the job is complete (max 2 minutes). Returns enriched contact data or an error message.
Solo lectura
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['jobId'], 'properties': {'jobId': {'type': 'string', 'description': 'The jobId returned by submit_lookup or shown on the payment success page'}}}
check_payment
Check whether a Stripe checkout session has been paid and execute the next step. Call this after presenting the checkoutUrl to the user. If status is "pending", wait a few seconds and call again. - If called after submit_lookup: once status is "done" call check_lookup with the returned jobId. - If called after audience_start_run: once status is "done" call audience_download_run with the returned runId.
Solo lectura
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['sessionId'], 'properties': {'sessionId': {'type': 'string', 'description': 'The sessionId returned by submit_lookup or audience_start_run when payment was required'}}}
set_auth_token
Set the user's YourICP auth token for this session. Call this when the user pastes their auth token in the chat. This is an API credential, NOT YourICP billing tokens — billing tokens are the prepaid currency a run spends, and check_billing_balance reads them. Once set, the auth token is used for all API requests and card payment is no longer required. To get an auth token, the user can log in at https://mcp.youricp.com/authorize.
Solo lectura
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['authToken'], 'properties': {'authToken': {'type': 'string', 'description': 'The YourICP auth token pasted by the user'}}}
set_token
DEPRECATED — call set_auth_token instead. Sets the user's YourICP auth token for this session.
Solo lectura
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['token'], 'properties': {'token': {'type': 'string', 'description': 'The YourICP auth token pasted by the user'}}}
submit_lookup
Submit a contact enrichment job for one or more email addresses or LinkedIn profile URLs. Provide emails, linkedInUrls, or both. If logged in, the job is charged to the account's YourICP billing-token balance (1 billing token per contact matched, 29 if phone validation runs, where 100 billing tokens = $1.00) and returns a jobId — call check_lookup to retrieve results. check_billing_balance shows what the balance covers. If the balance is short, this returns error "mcp_insufficient_tokens" with required, available and shortfall counts — tell the user exactly how many tokens to top up at app.youricp.com and do NOT retry until they have. If it returns "mcp_no_billing_account", only support can fix it — do NOT retry. If the user is not logged in, card payment is required instead: this tool returns a checkoutUrl and sessionId — present the URL, then call check_payment. Do NOT retry automatically on failure.
Destructivo
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'emails': {'type': 'array', 'items': {'type': 'string', 'format': 'email', 'pattern': "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"}, 'maxItems': 50, 'description': 'List of email addresses to look up'}, 'userEmail': {'type': 'string', 'description': 'Email address of the user requesting the lookup (used for payment receipt when payment is required)'}, 'linkedInUrls': {'type': 'array', 'items': {'type': 'string', 'format': 'uri'}, 'maxItems': 50, 'description': 'List of LinkedIn profile URLs to look up'}}}
Añadido
audience_download_run
17 de September de 2026 a las 12:38
Añadido
check_billing_balance
17 de September de 2026 a las 12:38
Añadido
audience_start_run
17 de September de 2026 a las 12:38
Añadido
audience_preview
17 de September de 2026 a las 12:38
Añadido
audience_quick_preview
17 de September de 2026 a las 12:38
Añadido
audience_get_filters
17 de September de 2026 a las 12:38
Añadido
audience_start
17 de September de 2026 a las 12:38
Añadido
check_payment
17 de September de 2026 a las 12:38
Añadido
check_lookup
17 de September de 2026 a las 12:38
Añadido
submit_lookup
17 de September de 2026 a las 12:38
Añadido
activate_login
17 de September de 2026 a las 12:38
Añadido
set_token
17 de September de 2026 a las 12:38
Añadido
set_auth_token
17 de September de 2026 a las 12:38