Talpy Aya — AI recruiter (WhatsApp interviews)

ai.talpyPublished by talpy.aiOfficial publisherv1.1.0Updated Oct 24, 2026

AI recruiter: create jobs, send candidates to WhatsApp interviews, read cited scores.

VerifiedStreamable HTTPWeb executableCommunication & CollaborationBusiness & Commerce

Overview

AI-generated overview

Talpy Aya is a remote MCP server that lets an assistant manage AI-recruiter job openings, invite candidates to WhatsApp interviews, and read cited scores.

What you can do
  • List job openings with status and candidate counts, and open one job's evaluated competencies and weights
  • List a job's candidates by interview score, profile fit and pipeline stage, and read one candidate's per-competency scores, evidence, red flags and highlights
  • Read company-wide recruiting metrics: open jobs, candidates, completed interviews, average score and plan usage
  • Check the current plan, this cycle's usage and available plans with prices
  • Create a new job opening with its interview profile, as a draft by default or published
  • Add a candidate to a job and send them a real WhatsApp or e-mail interview invite
When to use it
Useful for recruiting teams already on Talpy who want an assistant to review pipelines, compare candidates and scores, check plan usage, or open jobs and invite candidates without leaving the chat.
Requirements
Remote streamable HTTP endpoint at talpy.ai. Requires a Talpy API key sent as an Authorization bearer header; the key needs the mcp:read scope, plus mcp:write to create jobs and invite candidates. The key is created in Talpy under API & integrations.
Before you install
The API key is a secret sent in the Authorization header; grant mcp:write only if the assistant should create jobs and invite candidates. Creating a job counts against the plan's open-job limit. Inviting a candidate sends a real WhatsApp message or e-mail to that person and uses an interview credit. Plan and pricing tools are read-only and never charge; payment happens only in the Talpy dashboard.

Installation

In SourceWeft

  1. Open Talpy Aya — AI recruiter (WhatsApp interviews) in the dashboard and add it to a workspace.
  2. Connect Authorization token credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/ai.talpy%2Faya/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "talpy-aya-ai-recruiter-whatsapp-intervie": {
      "type": "http",
      "url": "https://talpy.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

Tools

8

listar_vagas

List jobs

Lists the company's job openings with their status and how many candidates each one has. Read-only. Use it to find a job id before looking at candidates or inviting someone.

Parametersstatuslanguage

detalhar_vaga

Job details

Shows one job in detail, including the competencies Aya (the AI interviewer) evaluates and the weight of each — the criteria behind every candidate score. Read-only.

ParametersjobIdrequiredlanguage

listar_candidatos

List candidates

Lists the candidates of a job with their interview score, profile fit and pipeline stage, highest score first. Read-only. Does NOT return phone, e-mail or résumé.

ParametersjobIdrequiredstagelanguageminScore

detalhar_candidato

Candidate evaluation

Full evaluation of one candidate: score per competency, the evidence behind each score, red flags, highlights and the human decision if there is one. Read-only. Does NOT return phone, e-mail or résumé.

ParameterslanguagecandidateIdrequired

resumo_do_recrutamento

Recruiting summary

Company-wide recruiting numbers: open jobs, candidates, completed interviews, average score and plan usage. Read-only. Contains no personal data.

Parameterslanguage

planos_e_assinatura

Plans and subscription

Shows the company's current plan, this cycle's usage (interviews and open jobs against the limits), the plans available with prices, and the link to subscribe or change plan in the Talpy dashboard. Read-only: it never charges or changes the subscription — payment happens only in the dashboard.

Parameterslanguage

criar_vaga

Create job

Creates a new job opening in the company's Talpy account and generates the interview profile Aya will use (competencies and weights). By default the job is created as a DRAFT (not public); set publish=true to open it right away. Counts against the plan's open-job limit. Requires an API key with the mcp:write scope. Returns in a few seconds with the job id, its status, the dashboard link and profileStatus: "generating" means the full competency profile is still being built in the background (usually under a minute) — call detalhar_vaga later to see it.

Parameterstitlerequiredpublishlanguagesenioritydescriptionrequired

entrevistar_candidato

Send candidate to Aya's interview

Adds a candidate to a job and immediately invites them to an interview with Aya, the AI recruiter. SIDE EFFECTS: with a phone number it sends a real WhatsApp invite to the candidate; without a phone but with an e-mail it sends a real e-mail with the link to the web interview. Uses one interview from the company's balance when the interview happens. Requires an API key with the mcp:write scope. Only invite people who applied or agreed to be contacted. Returns candidateId, interviewId and the invite channel.

ParametersnamerequiredemailjobIdrequiredphonelanguageresumeText

Version history

2
  1. v1.1.0LatestOct 1, 2026
  2. v1.0.0Sep 29, 2026

Score

83% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • LicenseNot applicable

    A hosted service is used under its provider's terms, so no license is expected here. This check is left out of the percentage.