Taleez MCP by usefulapi

io.usefulapiPublished by usefulapi.ioOfficial publisherv1.7.4Updated Nov 7, 2026

Read Taleez recruiting data; create or update candidates and add them to pools or jobs.

The publisher's own server: Ably MCP by usefulapi

VerifiedStreamable HTTPWeb executableProductivity & WorkflowBusiness & Commerce

Overview

AI-generated overview

Connects an assistant to Taleez recruiting data: browse jobs, candidates, pools and interviews, and create or update candidate records.

What you can do
  • List and inspect job postings, pipeline steps, status history, application questions and job counts
  • Read candidates with their applications, custom properties, talent pools, documents and scheduled events
  • List talent pools, pool members, recruiters, units and company calendar events
  • Create and update candidates, set custom candidate properties, and add candidates to pools or jobs
  • Check monthly tool-call usage, request a missing feature, upgrade or cancel the paid plan
When to use it
Useful for recruiters or hiring teams already on Taleez who want to query their pipeline in natural language, e.g. which jobs are published, where a candidate stands, or which pools a person belongs to, and to add candidates without opening the app.
Requirements
Remote MCP endpoint added by URL only; sign-in is via OAuth with the user's Taleez credentials, so no API key or Authorization header goes in the client config. A Taleez account with a scoped API key is needed. Free plan allows 50 tool calls per month.
Before you install
Candidates are personal data (names, e-mail, phone, CV links, documents); use only for the user's own recruiting. Five tools write to Taleez: creating candidates is not idempotent, updates replace social links and location, and property updates can clear choices. Paid plans cost money via a Stripe checkout link, and cancellation gives no refund for the current period.

Installation

In SourceWeft

  1. Open Taleez MCP by usefulapi in the dashboard and add it to a workspace.
  2. 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/io.usefulapi%2Ftaleez/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": {
    "taleez-by-usefulapi": {
      "type": "http",
      "url": "https://taleez.usefulapi.io/mcp"
    }
  }
}

README

Taleez MCP by usefulapi

Connect your scoped Taleez API key to an AI assistant.

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://taleez.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http taleez https://taleez.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "taleez": {      "url": "https://taleez.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Taleez credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/taleez/

Tools

ToolTypeWhat it does
taleez_list_jobsreadList jobs
taleez_get_jobreadGet job
taleez_get_job_stepsreadGet job pipeline steps
taleez_get_job_statusesreadGet job status history
taleez_get_job_questionsreadGet job application questions
taleez_get_job_filtersreadCount jobs by filter
taleez_list_job_propertiesreadList job properties
taleez_list_candidatesreadList candidates
taleez_get_candidatereadGet candidate
taleez_get_candidate_applicationsreadGet candidate applications
taleez_get_candidate_propertiesreadGet candidate properties
taleez_get_candidate_poolsreadGet candidate pools
taleez_get_candidate_documentsreadGet candidate documents
taleez_get_candidate_eventsreadGet candidate events
taleez_list_candidate_propertiesreadList candidate properties
taleez_list_poolsreadList talent pools
taleez_list_pool_candidatesreadList pool candidates
taleez_list_recruitersreadList recruiters
taleez_list_unitsreadList units
taleez_list_eventsreadList events
taleez_create_candidatewriteCreate candidate
taleez_update_candidatewriteUpdate candidate
taleez_set_candidate_propertieswriteSet candidate properties
taleez_add_candidates_to_poolwriteAdd candidates to a pool
taleez_add_candidates_to_jobwriteAdd candidates to a job
taleez_usage_statusmetaUsage status (free-tier meter)
taleez_request_featuremetaRequest a missing feature
taleez_upgrademetaUpgrade to Pro or Pro+
taleez_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro (per secret API key)$9/mo or $90/yr (2 months free)Unlimited*

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with taleez_upgrade (it returns a Stripe Checkout link). Cancel any time with taleez_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running taleez_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT

Source: servers/taleez/README.md at commit 4046075

Tools

25

taleez_list_jobs

List jobs

List the job postings of the company (id, label, status DRAFT/PUBLISHED/DONE/SUSPENDED, contract, location, recruiter, unit, tags, visibility, public URL). Filter by status, contract, unit, city, tag, company label or visibility; sort by creation or publication date. Job and profile descriptions are only included with with_details. GET /0/jobs.

Parameterstagcitypagestatussort_byunit_idcontractpage_sizevisibilitywith_propswith_detailscompany_label+1 more

taleez_get_job

Get job

One job posting by id with its full details: descriptions, contract, location, recruiter, unit, tags, custom properties, public and application URLs. GET /0/jobs/{id}.

Parametersjob_idrequired

taleez_get_job_steps

Get job pipeline steps

The recruitment pipeline steps of a job in order (id, name, order). Use them to read where each candidate stands. GET /0/jobs/{id}/steps.

Parametersjob_idrequired

taleez_get_job_statuses

Get job status history

The status history of a job: each change (date timestamp, status DRAFT/PUBLISHED/SUSPENDED/DONE). GET /0/jobs/{id}/statuses.

Parametersjob_idrequired

taleez_get_job_questions

Get job application questions

The questions candidates answer when applying to a job (id, label, type, required, choices). GET /0/jobs/{id}/questions.

Parametersjob_idrequired

taleez_get_job_filters

Count jobs by filter

The total number of jobs and the job counts per status, contract, city, tag and company label (only values with at least one job). A quick overview of the hiring activity. GET /0/jobs/filters.

Takes no parameters.

taleez_list_job_properties

List job properties

The custom job properties defined in the account (id, name, type, choices). GET /0/job-properties.

Parameterspagepage_size

taleez_list_candidates

List candidates

List the candidates in the company (id, name, mail, phone, language, location, social links, unit, creation date). Filter by exact e-mail address to find one person. Custom properties only with with_props. Candidates contain personal data: use it only for the user's own recruiting. GET /0/candidates.

Parametersmailpagepage_sizewith_props

taleez_get_candidate

Get candidate

One candidate by id: name, mail, phone, language, location, social links, unit, CV link and custom properties. GET /0/candidates/{id}.

Parameterscandidate_idrequired

taleez_get_candidate_applications

Get candidate applications

Where a candidate stands: every application or association (type SPONTANEOUS, APPLICATION_TO_A_JOB, ASSOCIATED_TO_A_JOB...) with the job id, current pipeline step, rejected/hired dates and the step history. GET /0/candidates/{id}/applications.

Parameterscandidate_idrequired

taleez_get_candidate_properties

Get candidate properties

The custom property values of a candidate (property id, name key, type, value or choices). GET /0/candidates/{id}/properties.

Parameterscandidate_idrequired

taleez_get_candidate_pools

Get candidate pools

The talent pools a candidate belongs to (pool id, name, date added, referrer). GET /0/candidates/{id}/pools.

Parameterscandidate_idrequired

taleez_get_candidate_documents

Get candidate documents

The documents attached to a candidate (CV, cover letter...): id, name, date, size and file URL. GET /0/candidates/{id}/documents.

Parameterscandidate_idrequired

taleez_get_candidate_events

Get candidate events

The events (interviews, calls, meetings) scheduled with a candidate: subject, start/end, location, meeting URL, attendees. GET /0/candidates/{id}/events.

Parameterscandidate_idrequired

taleez_list_candidate_properties

List candidate properties

The custom candidate properties defined in the account (id, name, type, choices, disabled). Use the ids with taleez_set_candidate_properties. GET /0/candidate-properties.

Parameterspagepage_sizewith_disabled

taleez_list_pools

List talent pools

List the talent pools of the company (id, name, dates, recruiter). GET /0/pools.

Parameterspagepage_size

taleez_list_pool_candidates

List pool candidates

The candidates in one talent pool. Custom properties only with with_props. GET /0/pools/{id}/candidates.

Parameterspagepool_idrequiredpage_sizewith_props

taleez_list_recruiters

List recruiters

List the recruiters (users) of the company. Use the ids to read who owns a job or to credit a new candidate. GET /0/recruiters.

Parameterspagepage_size

taleez_list_units

List units

List the units (entities, subsidiaries, sites) of the company. Use the ids to filter jobs. GET /0/units.

Parameterspagepage_size

taleez_list_events

List events

List the company's calendar events (interviews, meetings): subject, start/end timestamps, location, meeting URL, job id, attendees. GET /0/events.

Parameterspagesort_bypage_sizesort_direction

taleez_create_candidate

Create candidate

WRITE: add a new candidate to the Taleez database (first and last name required; the e-mail, if given, must be unique in the company). Creates a record only: the candidate is not attached to a job and no e-mail is sent by this call. Not idempotent: calling twice with no mail creates two candidates. POST /0/candidates.

Parameterslangmailphonesourceunit_idlocationlast_namerequiredfirst_namerequiredrecruiter_idsocial_links

taleez_update_candidate

Update candidate

WRITE: change a candidate's name, e-mail, phone, social links or location. The current record is read first and unchanged name, mail and phone are sent back, so only what you pass changes (Taleez' update endpoint otherwise needs first and last name). Social links and location, when given, REPLACE the existing ones (an empty social_links object removes them all). Overwrites data; no message is sent. POST /0/candidates/{id}.

Parametersmailphonelocationlast_namefirst_namecandidate_idrequiredsocial_links

taleez_set_candidate_properties

Set candidate properties

WRITE: set custom property values on a candidate. For a property without choices pass value (DATE as yyyy-MM-dd); for a property with choices pass choices (choice ids, see taleez_list_candidate_properties). An empty choices list removes all selected choices unless append_choices is true. Overwrites the previous values of the listed properties. POST /0/candidates/{id}/properties.

Parameterspropertiesrequiredcandidate_idrequired

taleez_add_candidates_to_pool

Add candidates to a pool

WRITE: add existing candidates to a talent pool (see taleez_list_pools). Adding a candidate already in the pool is harmless. No message is sent. POST /0/pools/{id}/candidates.

Parameterspool_idrequiredcandidate_idsrequired

taleez_add_candidates_to_job

Add candidates to a job

WRITE: associate existing candidates to a job so they appear in its recruitment pipeline (the vendor's 'add candidates to a job'; this is an association made by the recruiter, not a candidate application, and this call sends no message). Pass location_id for a job with several locations. POST /0/jobs/{id}/candidates.

Parametersjob_idrequiredlocation_idcandidate_idsrequired

Version history

10
  1. v1.7.4LatestNov 7, 2026
  2. v1.6.3Nov 5, 2026
  3. v1.6.2Nov 5, 2026
  4. v1.6.1Nov 4, 2026
  5. v1.6.0Nov 3, 2026
  6. v1.5.1Nov 3, 2026
  7. v1.4.0Nov 1, 2026
  8. v1.2.0Oct 31, 2026
  9. v1.1.0Oct 31, 2026
  10. v1.0.1Oct 31, 2026

Score

100% 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
  • License10 pts

Other Usefulapi integrations

Ably MCP by usefulapi

io.usefulapiOfficial publisher

Hosted MCP server for Ably realtime messaging: inspect channel history, presence and occupancy, publish messages, and review app usage and configuration.

Streamable HTTPWeb executable
Cloud & Infrastructure15 toolsNov 7, 2026

Woffu MCP by usefulapi

io.usefulapiOfficial publisher

Hosted read-only MCP server that lets an assistant look up Woffu company users, employment contracts, departments and offices.

Streamable HTTPWeb executable
Business & Commerce5 toolsNov 7, 2026

White Label Loyalty MCP by usefulapi

io.usefulapiOfficial publisher

Hosted MCP server for White Label Loyalty: browse rewards, read a customer's points wallet and tier progress, and buy rewards with points.

Streamable HTTPWeb executable
Business & Commerce5 toolsNov 7, 2026

Weekdone MCP by usefulapi

io.usefulapiOfficial publisher

Hosted Weekdone connector that lets an assistant read weekly reports, teams, objectives and KPIs, and add report items, comments and KPI values.

Streamable HTTPWeb executable
Data & Analytics15 toolsNov 7, 2026

WebinarKit MCP by usefulapi

io.usefulapiOfficial publisher

Hosted read-only MCP server that lets an assistant list WebinarKit webinars, their dates, series, meetings and white-label sub-accounts.

Streamable HTTPWeb executable
Business & Commerce5 toolsNov 7, 2026