Conectar
Una URL, Streamable HTTP, sin sesiones que gestionar. Las herramientas públicas funcionan sin nada más. Para las que actúan en tu nombre, crea una clave en Ajustes → Agentes de IA y envíala como token bearer.
https://www.pairskill.com/api/mcpclaude mcp add --transport http pairskill https://www.pairskill.com/api/mcp --header "Authorization: Bearer psk_…"{
"mcpServers": {
"pairskill": {
"url": "https://www.pairskill.com/api/mcp",
"headers": {
"Authorization": "Bearer psk_…"
}
}
}
}npx -y mcp-remote https://www.pairskill.com/api/mcp --header "Authorization: Bearer psk_…"Sin clave
Todo lo que ve un visitante en el sitio: puestos abiertos, la taxonomía de habilidades, perfiles públicos, demanda por país y la fórmula de puntuación como recurso pairskill://matching-formula.
| Herramienta | Quién | Qué hace |
|---|---|---|
search_skills | Cualquiera | Find skills in the PairSkill taxonomy by any name or synonym in the launch languages. |
suggested_skills | Cualquiera | The usual skills for a field (category), most essential first. |
get_profile | Cualquiera | A public talent profile by its slug (named profiles only; anonymous ones are never returned). |
match_skill_names | Cualquiera | Match skill names (as written on LinkedIn or a CV) to PairSkill skills. Returns the matched skills and the names it could not place. |
get_role | Cualquiera | One role with its skills, levels, pay range, practicalities and company. Open roles are public. |
search_roles | Cualquiera | Search open roles by text, country (remote roles always included), field, work mode or skills. |
preview_pool | Cualquiera | How many published profiles meet a set of must-have skills, country and languages: the live pool counter. |
get_passport | Cualquiera | A shared skill passport by its key: a named slug or an anonymous token. Levels, assessed skills with dates, ESCO URIs. |
skill_demand | Cualquiera | Open roles and available candidates per skill and country (EU), refreshed nightly. Counts under 10 are bucketed. Filter by country (ISO code) and optionally a skill slug. |
search_skills- Quién
- Cualquiera
- Qué hace
- Find skills in the PairSkill taxonomy by any name or synonym in the launch languages.
suggested_skills- Quién
- Cualquiera
- Qué hace
- The usual skills for a field (category), most essential first.
get_profile- Quién
- Cualquiera
- Qué hace
- A public talent profile by its slug (named profiles only; anonymous ones are never returned).
match_skill_names- Quién
- Cualquiera
- Qué hace
- Match skill names (as written on LinkedIn or a CV) to PairSkill skills. Returns the matched skills and the names it could not place.
get_role- Quién
- Cualquiera
- Qué hace
- One role with its skills, levels, pay range, practicalities and company. Open roles are public.
search_roles- Quién
- Cualquiera
- Qué hace
- Search open roles by text, country (remote roles always included), field, work mode or skills.
preview_pool- Quién
- Cualquiera
- Qué hace
- How many published profiles meet a set of must-have skills, country and languages: the live pool counter.
get_passport- Quién
- Cualquiera
- Qué hace
- A shared skill passport by its key: a named slug or an anonymous token. Levels, assessed skills with dates, ESCO URIs.
skill_demand- Quién
- Cualquiera
- Qué hace
- Open roles and available candidates per skill and country (EU), refreshed nightly. Counts under 10 are bucketed. Filter by country (ISO code) and optionally a skill slug.
En tu nombre
Una clave da al agente exactamente tus permisos, nada más: la misma seguridad por filas, límites del plan y reglas de anonimato que la app. Un agente de empresa ve a los candidatos anónimos como «Candidato XXXX» hasta que aceptan; un agente de talento decide qué compartir aceptando o rechazando.
| Herramienta | Quién | Qué hace |
|---|---|---|
my_skills | Cualquier clave | The signed-in talent’s skills with level, years, whether it is assessed and when a re-check is due. |
set_my_skill | Cualquier clave | Add a skill to the signed-in talent’s profile or change its level and years. A changed level is self-rated until checked again. |
remove_my_skill | Cualquier clave | Remove a skill from the signed-in talent’s profile. |
my_profile | Cualquier clave | The signed-in talent’s profile, including the private pay floor. Null when there is none yet. |
update_my_profile | Cualquier clave | Change fields of the signed-in talent’s profile (tagline, bio, location, availability, work modes, languages, visibility, …). Only the given fields change. |
set_visibility | Cualquier clave | Anonymous (employers see “Candidate XXXX” until you accept an invitation) or public (name visible). |
set_pay_floor | Cualquier clave | Set or clear the private minimum pay. Employers never see it; it labels roles below it for you. |
set_profile_published | Cualquier clave | Pause or resume the profile: a paused profile is not matched or shown to anyone. |
complete_onboarding | Cualquier clave | Create or replace the signed-in talent’s whole profile in one call: field, skills with levels, industries, practicalities, visibility and the private pay floor. Publishes it for matching. |
my_company | Cualquier clave | The signed-in employer’s company, their role on the team (owner, member, viewer) and plan limits with usage. |
create_company | Cualquier clave | Create the employer’s company (the caller becomes its owner). Needed before posting roles. |
update_company | Cualquier clave | Change the company profile (owner only): name, country, size, industry, description, website, location. |
request_company_verification | Cualquier clave | Ask PairSkill to verify the company manually (when the VAT check is not available). |
team_members | Cualquier clave | People on the employer’s team and open team invites. |
invite_team_member | Cualquier clave | Invite a colleague by email as member (hires) or viewer (looks only). Returns the invite link; seats are limited by plan. |
remove_team_member | Cualquier clave | Remove a teammate or cancel an open team invite (owner only). |
my_roles | Cualquier clave | The employer’s roles (draft, open, closed) with their requirements. |
create_role | Cualquier clave | Create a role for the employer’s company. With publish=true it opens at once (a pay range is required by EU pay transparency, and the plan limits open roles). |
update_role | Cualquier clave | Replace a role’s details and requirements (the role keeps its status). |
set_role_status | Cualquier clave | Open, close or return a role to draft. Opening needs a pay range and a free open-role slot on the plan. |
role_templates | Cualquier clave | Saved role templates of the company (Growth plan). |
save_role_template | Cualquier clave | Save a role setup as a reusable template (Growth plan). |
role_candidates | Cualquier clave | Candidates for one of the employer’s roles, ranked by the published formula with the full breakdown. Anonymous candidates appear as “Candidate XXXX” until they accept an invitation. Records the ranking shown (AI Act log). |
my_matches | Cualquier clave | Open roles ranked for the signed-in talent, with score, breakdown and whether pay is below their private minimum. |
explain_fit | Cualquier clave | Why a candidate fits a role: per skill the candidate’s level against the required level and its effect, industries and practicalities. Talent: your own fit for any open role. Employer: a candidate in your role’s pool. |
set_role_interest | Cualquier clave | Mark an open role as interested (the employer sees it), saved (only you), passed, or clear the mark (null). |
my_interests | Cualquier clave | The signed-in talent’s interested, saved and passed roles. |
interested_candidates | Cualquier clave | Candidates who marked one of the employer’s roles as interesting (ids; read cards with role_candidates). |
search_talent | Cualquier clave | Find candidates by skill in any launch language (e.g. "react", "könyvelés"), optionally in or open to a country. Anonymous candidates appear as “Candidate XXXX”. |
my_pools | Cualquier clave | The company’s candidate pools (saved lists) with member counts. Growth plan. |
create_pool | Cualquier clave | Create a named candidate pool (Growth plan). |
add_to_pool | Cualquier clave | Add a candidate to a pool, optionally with a private note. Anonymous candidates stay anonymous. |
remove_from_pool | Cualquier clave | Remove a candidate from a pool. |
pool_members | Cualquier clave | Candidates in a pool as pseudonymous cards (name only once revealed), with notes. |
invite_candidate | Cualquier clave | Invite a candidate to one of the employer’s open roles with a short message. The candidate stays anonymous until they accept; the ranking you acted on is recorded. Needs the DPA and a free invitation on the plan. |
my_invitations | Cualquier clave | Invitations the signed-in talent received: role, company, message, status and their score for the role. |
company_invitations | Cualquier clave | Every invitation the employer’s company sent, across roles, with status and the candidate (alias until accepted). |
respond_invitation | Cualquier clave | Accept (opens a conversation and shows the employer your name) or decline an invitation, optionally with a reason (skills, interview, salary, other). |
withdraw_invitation | Cualquier clave | Withdraw a pending invitation with the reason (recorded in the decision log). |
conversations | Cualquier clave | The signed-in person’s conversations (opened by accepted invitations) with the last message and unread count. |
get_conversation | Cualquier clave | One conversation with its messages (oldest first). Marks the other side’s messages as read. |
send_message | Cualquier clave | Send a message in an open conversation. With attachments on, up to five files uploaded first with attachment_upload_url. |
close_conversation | Cualquier clave | End a conversation: no new messages; the history stays readable for both sides. |
propose_hire | Cualquier clave | Propose hiring the candidate of an accepted conversation, with the main reason for the decision (decision log). The candidate confirms or declines. |
respond_hire | Cualquier clave | Confirm or decline a hire proposal (candidate). |
rate_hire | Cualquier clave | Rate a confirmed hire from 1 to 5 (each side rates once; used to check the formula, never shown publicly). |
my_hires | Cualquier clave | Hires the signed-in person is part of (proposed, confirmed, declined). |
my_notifications | Cualquier clave | The signed-in person’s latest updates (invitations, replies, messages, hires) with read state. |
mark_notifications_read | Cualquier clave | Mark updates as read: the given ids, or all. |
inbox | Cualquier clave | What waits on the signed-in person: pending invitations and hire proposals (needs you), unread messages, unread updates. |
skill_check_status | Cualquier clave | For each of the signed-in talent’s skills: assessed date, re-check due, cooldown end and whether a check exists. |
my_passport | Cualquier clave | The signed-in talent’s passport mode (off, named, anonymous) and its two links. |
set_passport_mode | Cualquier clave | Share the skill passport: off, named (with your name, at your slug) or anonymous (a token link, no name). |
whoami | Cualquier clave | Who the key or session acts as: name, email, default workspace, language, whether a talent profile exists and the company with the role in it. |
update_account_settings | Cualquier clave | Change your display name, language, theme (system, light, dark) or the product-news choice. |
export_my_data | Cualquier clave | A download link for everything PairSkill holds about you (one JSON file). The link works only in your signed-in browser; give it to the person. |
billing_status | Cualquier clave | The company plan, its limits and usage, open roles with role-pass and boost end dates, and recent purchases. |
start_checkout | Cualquier clave | Start a Stripe Checkout: a role pass (60 days of unlimited invitations for one role), a boost (7 days promoted) or the Growth plan. Returns a payment URL for a person to open; money is never moved without them. |
fairness_stats | Cualquier clave | Fairness numbers for one of your roles from its latest ranking snapshot: how many candidates each must-have excludes, the score distribution, how many sit just under the cut, and the assessed share of the shortlist. |
decision_log | Cualquier clave | Every decision on one of your roles, newest first: invitations, responses and hires with the reason recorded, the ranking snapshot it relied on, and whether a person or an agent acted. Candidates appear by id. |
compliance_pack | Cualquier clave | Links to the AI Act compliance pack for one of your roles: a printable record (system summary, oversight, fairness, decisions, snapshots) and CSV files. Growth and Scale plans. |
my_api_keys | Cualquier clave | Your active agent keys: name, prefix, whether they may make changes, last use. Never the key itself. |
my_skills- Quién
- Cualquier clave
- Qué hace
- The signed-in talent’s skills with level, years, whether it is assessed and when a re-check is due.
set_my_skill- Quién
- Cualquier clave
- Qué hace
- Add a skill to the signed-in talent’s profile or change its level and years. A changed level is self-rated until checked again.
remove_my_skill- Quién
- Cualquier clave
- Qué hace
- Remove a skill from the signed-in talent’s profile.
my_profile- Quién
- Cualquier clave
- Qué hace
- The signed-in talent’s profile, including the private pay floor. Null when there is none yet.
update_my_profile- Quién
- Cualquier clave
- Qué hace
- Change fields of the signed-in talent’s profile (tagline, bio, location, availability, work modes, languages, visibility, …). Only the given fields change.
set_visibility- Quién
- Cualquier clave
- Qué hace
- Anonymous (employers see “Candidate XXXX” until you accept an invitation) or public (name visible).
set_pay_floor- Quién
- Cualquier clave
- Qué hace
- Set or clear the private minimum pay. Employers never see it; it labels roles below it for you.
set_profile_published- Quién
- Cualquier clave
- Qué hace
- Pause or resume the profile: a paused profile is not matched or shown to anyone.
complete_onboarding- Quién
- Cualquier clave
- Qué hace
- Create or replace the signed-in talent’s whole profile in one call: field, skills with levels, industries, practicalities, visibility and the private pay floor. Publishes it for matching.
my_company- Quién
- Cualquier clave
- Qué hace
- The signed-in employer’s company, their role on the team (owner, member, viewer) and plan limits with usage.
create_company- Quién
- Cualquier clave
- Qué hace
- Create the employer’s company (the caller becomes its owner). Needed before posting roles.
update_company- Quién
- Cualquier clave
- Qué hace
- Change the company profile (owner only): name, country, size, industry, description, website, location.
request_company_verification- Quién
- Cualquier clave
- Qué hace
- Ask PairSkill to verify the company manually (when the VAT check is not available).
team_members- Quién
- Cualquier clave
- Qué hace
- People on the employer’s team and open team invites.
invite_team_member- Quién
- Cualquier clave
- Qué hace
- Invite a colleague by email as member (hires) or viewer (looks only). Returns the invite link; seats are limited by plan.
remove_team_member- Quién
- Cualquier clave
- Qué hace
- Remove a teammate or cancel an open team invite (owner only).
my_roles- Quién
- Cualquier clave
- Qué hace
- The employer’s roles (draft, open, closed) with their requirements.
create_role- Quién
- Cualquier clave
- Qué hace
- Create a role for the employer’s company. With publish=true it opens at once (a pay range is required by EU pay transparency, and the plan limits open roles).
update_role- Quién
- Cualquier clave
- Qué hace
- Replace a role’s details and requirements (the role keeps its status).
set_role_status- Quién
- Cualquier clave
- Qué hace
- Open, close or return a role to draft. Opening needs a pay range and a free open-role slot on the plan.
role_templates- Quién
- Cualquier clave
- Qué hace
- Saved role templates of the company (Growth plan).
save_role_template- Quién
- Cualquier clave
- Qué hace
- Save a role setup as a reusable template (Growth plan).
role_candidates- Quién
- Cualquier clave
- Qué hace
- Candidates for one of the employer’s roles, ranked by the published formula with the full breakdown. Anonymous candidates appear as “Candidate XXXX” until they accept an invitation. Records the ranking shown (AI Act log).
my_matches- Quién
- Cualquier clave
- Qué hace
- Open roles ranked for the signed-in talent, with score, breakdown and whether pay is below their private minimum.
explain_fit- Quién
- Cualquier clave
- Qué hace
- Why a candidate fits a role: per skill the candidate’s level against the required level and its effect, industries and practicalities. Talent: your own fit for any open role. Employer: a candidate in your role’s pool.
set_role_interest- Quién
- Cualquier clave
- Qué hace
- Mark an open role as interested (the employer sees it), saved (only you), passed, or clear the mark (null).
my_interests- Quién
- Cualquier clave
- Qué hace
- The signed-in talent’s interested, saved and passed roles.
interested_candidates- Quién
- Cualquier clave
- Qué hace
- Candidates who marked one of the employer’s roles as interesting (ids; read cards with role_candidates).
search_talent- Quién
- Cualquier clave
- Qué hace
- Find candidates by skill in any launch language (e.g. "react", "könyvelés"), optionally in or open to a country. Anonymous candidates appear as “Candidate XXXX”.
my_pools- Quién
- Cualquier clave
- Qué hace
- The company’s candidate pools (saved lists) with member counts. Growth plan.
create_pool- Quién
- Cualquier clave
- Qué hace
- Create a named candidate pool (Growth plan).
add_to_pool- Quién
- Cualquier clave
- Qué hace
- Add a candidate to a pool, optionally with a private note. Anonymous candidates stay anonymous.
remove_from_pool- Quién
- Cualquier clave
- Qué hace
- Remove a candidate from a pool.
pool_members- Quién
- Cualquier clave
- Qué hace
- Candidates in a pool as pseudonymous cards (name only once revealed), with notes.
invite_candidate- Quién
- Cualquier clave
- Qué hace
- Invite a candidate to one of the employer’s open roles with a short message. The candidate stays anonymous until they accept; the ranking you acted on is recorded. Needs the DPA and a free invitation on the plan.
my_invitations- Quién
- Cualquier clave
- Qué hace
- Invitations the signed-in talent received: role, company, message, status and their score for the role.
company_invitations- Quién
- Cualquier clave
- Qué hace
- Every invitation the employer’s company sent, across roles, with status and the candidate (alias until accepted).
respond_invitation- Quién
- Cualquier clave
- Qué hace
- Accept (opens a conversation and shows the employer your name) or decline an invitation, optionally with a reason (skills, interview, salary, other).
withdraw_invitation- Quién
- Cualquier clave
- Qué hace
- Withdraw a pending invitation with the reason (recorded in the decision log).
conversations- Quién
- Cualquier clave
- Qué hace
- The signed-in person’s conversations (opened by accepted invitations) with the last message and unread count.
get_conversation- Quién
- Cualquier clave
- Qué hace
- One conversation with its messages (oldest first). Marks the other side’s messages as read.
send_message- Quién
- Cualquier clave
- Qué hace
- Send a message in an open conversation. With attachments on, up to five files uploaded first with attachment_upload_url.
close_conversation- Quién
- Cualquier clave
- Qué hace
- End a conversation: no new messages; the history stays readable for both sides.
propose_hire- Quién
- Cualquier clave
- Qué hace
- Propose hiring the candidate of an accepted conversation, with the main reason for the decision (decision log). The candidate confirms or declines.
respond_hire- Quién
- Cualquier clave
- Qué hace
- Confirm or decline a hire proposal (candidate).
rate_hire- Quién
- Cualquier clave
- Qué hace
- Rate a confirmed hire from 1 to 5 (each side rates once; used to check the formula, never shown publicly).
my_hires- Quién
- Cualquier clave
- Qué hace
- Hires the signed-in person is part of (proposed, confirmed, declined).
my_notifications- Quién
- Cualquier clave
- Qué hace
- The signed-in person’s latest updates (invitations, replies, messages, hires) with read state.
mark_notifications_read- Quién
- Cualquier clave
- Qué hace
- Mark updates as read: the given ids, or all.
inbox- Quién
- Cualquier clave
- Qué hace
- What waits on the signed-in person: pending invitations and hire proposals (needs you), unread messages, unread updates.
skill_check_status- Quién
- Cualquier clave
- Qué hace
- For each of the signed-in talent’s skills: assessed date, re-check due, cooldown end and whether a check exists.
my_passport- Quién
- Cualquier clave
- Qué hace
- The signed-in talent’s passport mode (off, named, anonymous) and its two links.
set_passport_mode- Quién
- Cualquier clave
- Qué hace
- Share the skill passport: off, named (with your name, at your slug) or anonymous (a token link, no name).
whoami- Quién
- Cualquier clave
- Qué hace
- Who the key or session acts as: name, email, default workspace, language, whether a talent profile exists and the company with the role in it.
update_account_settings- Quién
- Cualquier clave
- Qué hace
- Change your display name, language, theme (system, light, dark) or the product-news choice.
export_my_data- Quién
- Cualquier clave
- Qué hace
- A download link for everything PairSkill holds about you (one JSON file). The link works only in your signed-in browser; give it to the person.
billing_status- Quién
- Cualquier clave
- Qué hace
- The company plan, its limits and usage, open roles with role-pass and boost end dates, and recent purchases.
start_checkout- Quién
- Cualquier clave
- Qué hace
- Start a Stripe Checkout: a role pass (60 days of unlimited invitations for one role), a boost (7 days promoted) or the Growth plan. Returns a payment URL for a person to open; money is never moved without them.
fairness_stats- Quién
- Cualquier clave
- Qué hace
- Fairness numbers for one of your roles from its latest ranking snapshot: how many candidates each must-have excludes, the score distribution, how many sit just under the cut, and the assessed share of the shortlist.
decision_log- Quién
- Cualquier clave
- Qué hace
- Every decision on one of your roles, newest first: invitations, responses and hires with the reason recorded, the ranking snapshot it relied on, and whether a person or an agent acted. Candidates appear by id.
compliance_pack- Quién
- Cualquier clave
- Qué hace
- Links to the AI Act compliance pack for one of your roles: a printable record (system summary, oversight, fairness, decisions, snapshots) and CSV files. Growth and Scale plans.
my_api_keys- Quién
- Cualquier clave
- Qué hace
- Your active agent keys: name, prefix, whether they may make changes, last use. Never the key itself.
Claves
Las claves se muestran una vez y solo se guardan como hash. Revoca una en Ajustes y deja de funcionar al instante. Hasta 10 claves activas por cuenta. Los agentes que usan una clave aparecen en tu exportación de datos.
Puntuaciones y decisiones
Los agentes reciben el mismo desglose que las personas: habilidad por habilidad, años en el sector, aspectos prácticos. Las puntuaciones ordenan a los candidatos; nunca rechazan a nadie. Invitar, aceptar o contratar sigue siendo una decisión humana, y cada decisión registra un motivo.
Límites y soporte
Las invitaciones y los puestos abiertos cuentan para tu plan igual que en la app. Las peticiones tienen un límite por cuenta. Dudas o una herramienta que echas en falta: hello@pairskill.com.