MCP Tools

The ModernLoop MCP Server exposes read and write tools on the default endpoint. Tool availability is specific to your endpoint, OAuth scopes, and organization entitlements. Call tools/list after connecting for the authoritative tool list and input schema for your session. Two of the read tools are skill guides rather than data operations: list_modernloop_skills and load_modernloop_skill document the correct workflow, tool order, safety rules, and pitfalls for a scheduling domain. Load a guide before starting domain work — see Skill guides. Use the data model to find the right object and canonical ID, and MCP setup to troubleshoot missing tools or scopes. Call get_me first: its tool_access field predicts whether each public MCP tool can succeed with the token’s scopes. Endpoint variant and connection-level include_tools/exclude_tools filtering can further restrict visibility, while a listed tool can still return INSUFFICIENT_SCOPE; use tools/list for the active connection’s visible tools.

Tool reference

Tool	Description	Scope	Read-only toolset
`list_candidates`	Lookup candidates by id, name, email, ATS details, or creation and update timestamps.	`candidates:read`	Yes
`get_candidate`	Get details for one candidate.	`candidates:read`	Yes
`update_candidate`	Update a candidate.	`candidates:write`	No
`list_applications`	List applications by candidate, job, status, ATS id, or timestamps.	`applications:read`	Yes
`get_application`	Get details for one application.	`applications:read`	Yes
`update_application`	Update an application.	`applications:write`	No
`list_jobs`	List jobs by name, status, ATS id, or timestamps.	`jobs:read`	Yes
`get_job`	Get one job, including its resolved scheduling settings.	`jobs:read`	Yes
`update_job`	Update a job’s fallback name or internal note.	`jobs:write`	No
`list_job_stages`	List job stages by job id or by ids. Includes stage settings. At least one of ids or job_id is required; when both are supplied, only stages that satisfy both are returned.	`jobs:read`	Yes
`get_job_stage`	Get one job stage by id, including its settings.	`jobs:read`	Yes
`update_job_stage`	Update a job stage’s settings: automation, candidate notifications, self-schedule or availability-request defaults.	`jobs:write`	No
`list_users`	List user load, limits, pause status, and module training.	`users:read`	Yes
`get_user`	Get details for one user.	`users:read`	Yes
`update_user`	Update a user’s admin-managed profile, scheduling controls, load limits, or organization attributes.	`users:write`	No
`get_me`	Get the acting user, organization, and granted scopes for the current token.	No scope (any authenticated token)	Yes
`list_help_articles`	Search the ModernLoop help knowledge base by relevance-ranked query. Returns title, URL, snippet, and score.	No scope (any authenticated token)	Yes
`get_help_article`	Read one help article as Markdown with its canonical URL.	No scope (any authenticated token)	Yes
`list_interview_modules`	List interview modules by name, including member-count aggregates and training status. Use list_interview_module_members to retrieve the member list.	`interview_modules:read`	Yes
`get_interview_module`	Get details for one interview module.	`interview_modules:read`	Yes
`create_interview_module`	Create an interview module with training requirements and graduation rules.	`interview_modules:write`	No
`update_interview_module`	Update an interview module’s name, training requirements, graduation rules, or weekly limit.	`interview_modules:write`	No
`delete_interview_module`	Permanently delete one interview module and all of its interviewer memberships. This hard delete is irreversible.	`interview_modules:write`	No
`create_interview_module_member`	Add one interviewer to an interview module, optionally with training overrides.	`interview_modules:write`	No
`get_interview_module_stats`	Get member training counts for one interview module.	`interview_modules:read`	Yes
`list_interview_module_members`	List the interviewers in one interview module with their training progress, optionally filtered by training status.	`interview_modules:read`	Yes
`get_interview_module_member`	Get details for one interview module member.	`interview_modules:read`	Yes
`get_interview_module_member_stats`	Get detailed training statistics for one interview module member.	`interview_modules:read`	Yes
`update_interview_module_member`	Update an interviewer’s training membership, pause state, required counts, timestamps, or weekly limit in one interview module.	`interview_modules:write`	No
`delete_interview_module_member`	Remove one interviewer from an interview module, deleting their membership and training progress in it.	`interview_modules:write`	No
`get_organization`	Get the caller’s organization and its scheduling defaults.	`organization:read`	Yes
`update_organization`	Update the organization’s scheduling defaults: work hours, interviewer load limits, interview buffers, feedback writing time, or conflict keywords.	`organization:write`	No
`list_interview_events`	List interview events using person, candidate, application, job, status, and date filters.	`interviews:read`	Yes
`get_interview_event`	Get details for one interview event.	`interviews:read`	Yes
`list_schedules`	List schedule groups with nested interviews, optionally bounded by timestamps.	`schedules:read`	Yes
`get_schedule`	Get details for one schedule.	`schedules:read`	Yes
`list_scheduling_tasks`	List scheduling tasks by status, flagged, urgency, queue IDs, tags, delegation status, assignee, job, or application. By default, results cover all tasks in the organization; use `my_tasks: true` as the my tasks shorthand for tasks assigned to the acting user.	`tasks:read`	Yes
`get_scheduling_task`	Get details for one scheduling task.	`tasks:read`	Yes
`create_scheduling_task`	Create a scheduling task for an application and job stage.	`scheduling:write`	No
`update_scheduling_task`	Update assignee, urgency, queue, tags, debrief requirement, or meeting location.	`scheduling:write`	No
`cancel_scheduling_task`	Cancel a scheduling task with an optional reason.	`scheduling:write`	No
`list_task_queues`	List active scheduling task queues, optionally filtered by name.	`tasks:read`	Yes
`get_task_queue`	Get details for one scheduling task queue.	`tasks:read`	Yes
`list_templates`	List organization email and calendar templates by name or type.	`templates:read`	Yes
`get_template`	Get details for one organization email or calendar template.	`templates:read`	Yes
`list_modernloop_skills`	List available ModernLoop skill guides, optionally ranked by a fuzzy `query`.	No scope (any authenticated token)	Yes
`load_modernloop_skill`	Load one skill guide by exact name, its header only, or one bundled reference.	No scope (any authenticated token)	Yes
`submit_mcp_feedback`	Submit feedback about the MCP server itself: a tool bug, a missing capability, or workflow friction. Never includes candidate or customer data, PII, secrets, or raw tool arguments.	No scope (any authenticated token)	No

delete_interview_module, delete_interview_module_member, and cancel_scheduling_task are destructive. Read the current record and obtain explicit confirmation before calling them. create_scheduling_task requires an idempotency_key; reuse that key only when retrying the same intended create.

Skill guides

Skill guides are Markdown playbooks served over MCP. They describe the correct tool order, required inputs, safety rules, and common pitfalls for one scheduling domain, so an agent does not have to infer a workflow from tools/list.

Call list_modernloop_skills with topic keywords in query and a brief telemetry.intent. Omit query to list every applicable guide. Add include_header: true for descriptions, related guides, and bundled reference paths.
Call load_modernloop_skill with the exact skill_name from that response. Skill names are case-sensitive and are never inferred from topic words.
Use header_only: true to preview a guide, or resource_path to load one bundled reference without reloading the whole guide.

Both tools require telemetry.intent: a brief English statement of what you are doing. Never put candidate or employee data, argument values, or secrets in it — ModernLoop does not retain the raw text, and it is not a place for sensitive input. The beta catalog covers modernloop/task-triage, modernloop/candidate-investigation, modernloop/scheduling-task-creation, and modernloop/interviewer-capacity.

A guide is only listed and loadable when every tool it documents is visible to your token, endpoint, and connection filters. On /mcp/readonly, guides covering task writes are absent. An unavailable or unknown skill name returns the same NOT_FOUND response, so a failed load is never evidence that a guide exists.

Workflow prompts

Copy one of these into a connected MCP client. Replace the bracketed text with your context.

Triage my scheduling tasks

Use get_me first, then call list_scheduling_tasks with my_tasks: true for your open scheduling tasks. Group them by urgency, status, and queue; call get_scheduling_task for the highest-priority items. Do not change anything.

Create a scheduling task for a candidate

Find candidate [name or email], then find their active application for [job]. Read the application and its job stages, identify the requested stage, and summarize the target application and stage before creating a scheduling task. After I confirm, call create_scheduling_task with a new idempotency key and report the result.

Investigate why a candidate is not scheduled

Find candidate [name or email], then inspect their applications, scheduling tasks, schedules, and interview events. Explain the current status and blockers using only the returned data. Do not make changes.

Review interviewer capacity

List users matching [team, name, or module], then inspect the relevant users and interview-module training statistics. Identify people who are paused or near their configured limits. Do not make changes.

Troubleshoot a ModernLoop issue

Search the help knowledge base for [issue or error message] with list_help_articles, read the best matches with get_help_article, and summarize the recommended steps with canonical article links. If nothing relevant is found, say so and ask one clarifying question.

Find stale tasks in a queue

Find the task queue named [queue name], then list its scheduling tasks that have not been updated since [date]. Summarize status, assignee, urgency, and the next useful follow-up. Do not make changes.

Connect

Tool reference

Skill guides

Workflow prompts

Triage my scheduling tasks

Create a scheduling task for a candidate

Investigate why a candidate is not scheduled

Review interviewer capacity

Troubleshoot a ModernLoop issue

Find stale tasks in a queue

Further reading

​Tool reference

​Skill guides

​Workflow prompts

​Triage my scheduling tasks

​Create a scheduling task for a candidate

​Investigate why a candidate is not scheduled

​Review interviewer capacity

​Troubleshoot a ModernLoop issue

​Find stale tasks in a queue

​Further reading

Tool reference

Skill guides

Workflow prompts

Triage my scheduling tasks

Create a scheduling task for a candidate

Investigate why a candidate is not scheduled

Review interviewer capacity

Troubleshoot a ModernLoop issue

Find stale tasks in a queue

Further reading