PairSkill para agentes de IA

PairSkill ofrece un servidor oficial de Model Context Protocol (MCP). Claude, Cursor, ChatGPT y tus propios agentes pueden buscar puestos y talento, explicar un encaje y, con una clave, actuar por ti: publicar puestos, revisar candidatos clasificados, invitar, aceptar y conversar.

En esta página

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.

Endpoint
https://www.pairskill.com/api/mcp
Claude Code
claude mcp add --transport http pairskill https://www.pairskill.com/api/mcp --header "Authorization: Bearer psk_…"
Cursor · Claude Desktop (mcp.json)
{
  "mcpServers": {
    "pairskill": {
      "url": "https://www.pairskill.com/api/mcp",
      "headers": {
        "Authorization": "Bearer psk_…"
      }
    }
  }
}
Clientes sin transporte HTTP
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.

  • 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.

  • 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.