Ceipal MCP by usefulapi

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

Read job postings, applicants, submissions, clients, vendors, interviews and placements in Ceipal.

The publisher's own server: Ably MCP by usefulapi

VerifiedStreamable HTTPWeb executableProductivity & WorkflowBusiness & Commerce

Overview

AI-generated overview

Hosted read-only MCP access to Ceipal recruiting data: job postings, applicants, submissions, clients, vendors, interviews and placements.

What you can do
  • List job postings, requisitions, applicants, submissions, bench consultants, interviews and placements, one page at a time
  • List clients, client contacts, client notes, leads, vendors and account users
  • Fetch a single record by its encrypted id, including applicant documents and custom fields, client contacts and accounts, and placement pay details
  • Check monthly tool-call usage, request a missing feature, and upgrade or cancel the paid plan
When to use it
Useful when a recruiter or staffing team wants an assistant to answer questions over their Ceipal ATS — recent postings and their recruiters, a candidate's skills and work authorization, or the pipeline status of submissions — without exporting data by hand.
Requirements
Remote MCP endpoint; no local install. Sign-in is by OAuth, and on first connect you supply the Ceipal admin email, API password and API key from the Ceipal ATS Admin Panel API settings, set by an administrator. No keys go in the client config. Reads are limited to 60 per minute per account token.
Before you install
You hand the service your Ceipal admin email, API password and API key, which it validates and stores per user. All data tools are read-only, but they expose candidate personal data (emails, skills, work authorization, documents) and client, vendor and pay details to the assistant. Usage is metered: free plan 50 calls a month; Pro and Pro+ are paid subscriptions with Stripe checkout links, and cancellation gives no refund for the current period.

Installation

In SourceWeft

  1. Open Ceipal 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%2Fceipal/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": {
    "ceipal-by-usefulapi": {
      "type": "http",
      "url": "https://ceipal.usefulapi.io/mcp"
    }
  }
}

README

Ceipal MCP by usefulapi

Use your Ceipal account from Claude, Cursor, or any MCP client. Read job postings, requisitions, applicants, submissions, bench, clients, leads, vendors, interviews and placements. Hosted, no local install: connect with your own credentials.

Live endpoint: https://ceipal.usefulapi.io/mcp · Homepage: https://usefulapi.io

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://ceipal.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http ceipal https://ceipal.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": {    "ceipal": {      "url": "https://ceipal.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 Ceipal credentials.

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

On first connect you provide your admin email, the API password and the API key (Ceipal ATS Admin Panel → API settings). An administrator sets them. The server validates it and stores it per user. No keys go in config files.

Tools

ToolTypeWhat it does
ceipal_list_job_postingsreadList job postings
ceipal_list_job_requisitionsreadList job requisitions
ceipal_list_applicantsreadList applicants
ceipal_list_submissionsreadList submissions
ceipal_list_talent_benchreadList talent bench
ceipal_list_clientsreadList clients
ceipal_list_client_notesreadList client notes
ceipal_list_client_contactsreadList client contacts
ceipal_list_leadsreadList leads
ceipal_list_vendorsreadList vendors
ceipal_list_interviewsreadList interviews
ceipal_list_placementsreadList placements
ceipal_list_usersreadList users
ceipal_get_job_postingreadGet job posting
ceipal_get_job_requisitionreadGet job requisition
ceipal_get_applicantreadGet applicant
ceipal_get_submissionreadGet submission
ceipal_get_bench_consultantreadGet bench consultant
ceipal_get_clientreadGet client
ceipal_get_leadreadGet lead
ceipal_get_vendorreadGet vendor
ceipal_get_interviewreadGet interview
ceipal_get_placementreadGet placement
ceipal_get_userreadGet user
ceipal_usage_statusmetaUsage status (free-tier meter)
ceipal_request_featuremetaRequest a missing feature
ceipal_upgrademetaUpgrade to Pro or Pro+
ceipal_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 user)$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 ceipal_upgrade (it returns a Stripe Checkout link). Cancel any time with ceipal_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running ceipal_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT — see LICENSE. Documentation only; the server is hosted.

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

Tools

24

ceipal_list_job_postings

List job postings

List job postings, one page at a time. Read only. GET /v2/getJobPostingsList/. Reads are limited to 60 a minute per account token.

ParameterscitypagelimitstateclientskillscountryjobCodeisActivejobStatussearchKeymodifiedAfter+7 more

ceipal_list_job_requisitions

List job requisitions

List job requisitions, one page at a time. Read only. GET /v2/getRequisitionsList/. Reads are limited to 60 a minute per account token.

ParameterspagelimitjobCodemodifiedAfterbusinessUnitIdmodifiedBefore

ceipal_list_applicants

List applicants

List applicants (candidates), one page at a time. Read only. GET /v2/getApplicantsList/. Reads are limited to 60 a minute per account token.

ParameterspageemaillimitskillssourcecreatedByapplicantIdmobileNumbermodifiedAftercreatedAgoDaysmodifiedBeforeworkAuthorization

ceipal_list_submissions

List submissions

List submissions of applicants to a job, one page at a time. Read only. GET /v2/getSubmissionsList/. Reads are limited to 60 a minute per account token.

ParameterspagejobIdrequiredlimitisPipelinejobSeekerIdsubmissionIdmodifiedAfterbusinessUnitIdmodifiedBeforesubmittedAgoDays

ceipal_list_talent_bench

List talent bench

List bench consultants, one page at a time. Read only. GET /v2/getBenchList/. Reads are limited to 60 a minute per account token.

ParameterspageemaillimitcreatedAtbenchStatus

ceipal_list_clients

List clients

List clients, one page at a time. Read only. GET /v2/getClientsList/. Reads are limited to 60 a minute per account token.

ParameterspagelimitstatuscategorymodifiedAfterbusinessUnitIdmodifiedBefore

ceipal_list_client_notes

List client notes

List notes of a client or lead, one page at a time. Read only. GET /v2/getClientNotesList/. Reads are limited to 60 a minute per account token.

ParameterspagelimitclientIdleadTypemodifiedAftermodifiedBefore

ceipal_list_client_contacts

List client contacts

List client contacts, one page at a time. Read only. GET /v2/getClientContactsList/. Reads are limited to 60 a minute per account token.

ParameterspagelimitmodifiedAftermodifiedBefore

ceipal_list_leads

List leads

List sales leads, one page at a time. Read only. GET /v2/getLeadsList/. Reads are limited to 60 a minute per account token.

Parameterspagelimit

ceipal_list_vendors

List vendors

List vendors (staffing partners), one page at a time. Read only. GET /v2/getVendorsList/. Reads are limited to 60 a minute per account token.

Parameterspagelimit

ceipal_list_interviews

List interviews

List interviews, one page at a time. Read only. GET /v2/getInterviewsList/. Reads are limited to 60 a minute per account token.

ParameterspagelimitjobSeekerId

ceipal_list_placements

List placements

List placements, one page at a time. Read only. GET /v2/getPlacementsList/. Reads are limited to 60 a minute per account token.

ParameterspagejobIdlimitclientIdbusinessUnitId

ceipal_list_users

List users

List users of the Ceipal account, one page at a time. Read only. GET /v2/getUsersList/. Reads are limited to 60 a minute per account token.

Parameterspagelimit

ceipal_get_job_posting

Get job posting

Get one job posting by its encrypted id from ceipal_list_job_postings. Read only. GET /v2/getJobPostingDetails/{id}/.

Parametersjob_idrequired

ceipal_get_job_requisition

Get job requisition

Get one job requisition by its encrypted id from ceipal_list_job_requisitions. Read only. GET /v2/getRequistionsDetails/{id}/.

Parametersrequisition_idrequired

ceipal_get_applicant

Get applicant

Get one applicant with documents and custom fields by its encrypted id from ceipal_list_applicants. Read only. GET /v2/getApplicantDetails/{id}/.

Parametersapplicant_idrequired

ceipal_get_submission

Get submission

Get one submission by its encrypted id from ceipal_list_submissions. Read only. GET /v2/getSubmissionDetails/{id}/.

Parameterssubmission_idrequired

ceipal_get_bench_consultant

Get bench consultant

Get one bench consultant by its encrypted id from ceipal_list_talent_bench. Read only. GET /v2/getBenchDetails/{id}/.

Parametersbench_idrequired

ceipal_get_client

Get client

Get one client with contacts and accounts by its encrypted id from ceipal_list_clients. Read only. GET /v2/getClientDetails/{id}/.

Parametersclient_idrequired

ceipal_get_lead

Get lead

Get one sales lead with contacts by its encrypted id from ceipal_list_leads. Read only. GET /v2/getLeadsDetail/{id}/.

Parameterslead_idrequired

ceipal_get_vendor

Get vendor

Get one vendor with contacts by its encrypted id from ceipal_list_vendors. Read only. GET /v2/getVendorDetails/{id}/.

Parametersvendor_idrequired

ceipal_get_interview

Get interview

Get one interview by its encrypted id from ceipal_list_interviews. Read only. GET /v2/getInterviewDetails/{id}/.

Parametersinterview_idrequired

ceipal_get_placement

Get placement

Get one placement with pay details by its encrypted id from ceipal_list_placements. Read only. GET /v2/getPlacementDetails/{id}/.

Parametersplacement_idrequired

ceipal_get_user

Get user

Get one user by its encrypted id from ceipal_list_users. Read only. GET /v2/getUserDetails/{id}/.

Parametersuser_idrequired

Version history

6
  1. v1.3.4LatestNov 7, 2026
  2. v1.2.3Nov 5, 2026
  3. v1.2.2Nov 5, 2026
  4. v1.2.1Nov 4, 2026
  5. v1.2.0Nov 3, 2026
  6. v1.1.1Nov 3, 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