MCP Server

Available to all organizations — Tenzo hosts a Model Context Protocol server that exposes the read endpoints of the Tenzo Public API as tools that any MCP-compatible AI client can call, plus a submit_feedback write tool the assistant uses to log questions it struggled with (internal feedback only).

Overview

Tenzo’s MCP server lets you point an MCP-compatible client (Claude, ChatGPT, Microsoft Copilot, Gemini Spark, Cursor, Windsurf, etc.) at your Tenzo workspace and ask natural-language questions like “summarize the last 20 calls for job X” or “list applications stuck in screening for more than a week.” The model can call Tenzo tools directly to fetch the data it needs. There are two ways to connect:

OAuth connector (recommended) — sign in with your Tenzo account; no API key to manage. Works with hosted clients like Claude, ChatGPT, Microsoft Copilot, and Gemini Spark that support the MCP HTTP transport with OAuth 2.1, and with local clients (Claude Code, Cursor, Windsurf) that support remote OAuth servers. Use this whenever you can — access follows your Tenzo login and permissions automatically.
.mcp.json with an API key — a fallback for clients that can’t do the OAuth flow, or for users without a Tenzo account (e.g. a service or automation authenticating with an API key instead of a personal login).

The endpoint is the same everywhere: https://api.tenzo.ai/mcp. Jump to your client: Claude · ChatGPT · Microsoft Copilot · Gemini Spark · other local clients. The server is read-only for your recruiting data: the tools that proxy the Public API only expose GET endpoints. Write operations on recruiting data (creating jobs, upserting applications, posting comments) are not available through MCP — use the Public API directly for those. The one exception is submit_feedback, which lets the assistant record questions it struggled with so we can improve it; it writes only to an internal feedback log and exposes no recruiting data.

Option 1 — OAuth connector (Claude, ChatGPT, Microsoft Copilot, Gemini Spark)

Tenzo is published in the Claude, ChatGPT, and Microsoft Copilot connector directories, so you add it by finding Tenzo in the client’s connector list and clicking connect — no URL to paste, no API key. For Gemini Spark, add Tenzo as a custom app by pasting the MCP URL (Gemini does not currently offer a public directory submission for third-party connectors). The first time you use it, you sign in to Tenzo and approve access. The steps differ slightly per client.

Claude (Claude.ai and Desktop)

A connector added to your Claude account works across Claude.ai, Claude Desktop, and mobile.

Open the connector directory

Go to Customize → Connectors, click the +, and choose Browse connectors (or open claude.ai/directory).

Add Tenzo

Find and select Tenzo, then click Connect.

Approve access

Claude opens Tenzo’s sign-in page. Log in with your normal Tenzo account, then click Approve on the consent screen.Tenzo now appears in Claude’s tools list and is ready to use.

On Team and Enterprise plans, an Owner must first add Tenzo org-wide (Organization settings → Connectors → Browse connectors → Add to your team); each member then connects with their own Tenzo account. Claude Code doesn’t use account connectors — add Tenzo there with claude mcp add --transport http tenzo https://api.tenzo.ai/mcp, then run /mcp to complete the OAuth sign-in (or use the .mcp.json method below with an API key).

ChatGPT

Tenzo is a published ChatGPT app, so you just connect it from the directory — no Developer mode required (that’s only for custom MCP server URLs). Available on Plus, Pro, Business, Enterprise, and Edu plans.

Open the apps directory

In ChatGPT, open Plugins from the sidebar (or Settings → Plugins, formerly “Apps”).

Connect Tenzo

Find Tenzo in the directory and click Connect.

Approve access

ChatGPT opens Tenzo’s sign-in page. Log in with your Tenzo account and click Approve on the consent screen. In a chat, open + → More to use the Tenzo tools; approve individual actions when the approval card appears.

On Enterprise and Edu workspaces (and any workspace where apps are restricted), a workspace admin must enable Tenzo under Workspace settings → Apps before members see the Connect button.

Microsoft Copilot

Tenzo is a published Power Platform connector, so you add it to a Copilot Studio agent from the connector list — no server URL to enter.

Add a connector tool

Select your agent, open its Tools page, and choose Add a tool → Connector.

Select Tenzo

Search for Tenzo, select it, and pick the tool(s) you want to add. The Add tool pane opens.

Create a connection

Select Create new connection and sign in with your Tenzo account to approve access, then select Submit and Add and configure. Connections use each end user’s credentials by default.

Publish the agent

Tenzo’s read-only tools now appear on the agent’s Tools tab. Publish the agent and set its availability to make the tools reachable for end users in Microsoft 365 Copilot.

Tenzo is a premium connector, so it requires a Copilot Studio / Power Platform plan that includes premium connectors. A newly certified connector takes ~10–14 days to roll out to all regions after it goes live.

Access is scoped to your Tenzo organization and the permissions on your account. The connector cannot see data from other organizations.

Gemini Spark (custom app)

Gemini Spark can call Tenzo through Custom apps for Spark — paste Tenzo’s MCP URL; there is no official Gemini Connected Apps directory listing for Tenzo today. Google currently requires a personal Google Account with Gemini Spark / Google AI Ultra eligibility (availability varies by region and account type), Keep Activity on, and a desktop browser at gemini.google.com to add the custom app. After you connect once on web, Spark can use the same connection on mobile.

Open Connected Apps

Go to gemini.google.com → Settings & help → Connected Apps (under Personal Intelligence if needed).

Add Tenzo as a custom app

Under Custom apps for Spark, choose Add a custom app and enter:

https://api.tenzo.ai/mcp

Leave Advanced credentials empty — Tenzo supports Dynamic Client Registration and Google’s Client ID Metadata Document flow, so no client ID or secret is required.

Approve access

Gemini opens Tenzo’s sign-in page. Log in with your Tenzo account, then click Allow on the consent screen (the screen shows the Gemini / Google client name and hostname).

Use Tenzo in Spark

In a Spark chat, select Tenzo (or mention it with @) when you want Spark to query your recruiting data. Access is scoped to your Tenzo organization and permissions.

To disconnect, unlink or remove the custom app under Gemini Connected Apps (or manage linked apps in your Google Account). Tenzo issues short-lived access tokens only — no refresh tokens — so after unlink, Gemini cannot mint a new token without consent again.

If OAuth fails with an invalid redirect or unknown client error, confirm you pasted https://api.tenzo.ai/mcp exactly, Keep Activity is on, and you are on an eligible Gemini Spark account. You should not need Advanced credentials for Tenzo.

Revoking access

For Claude, ChatGPT, and Gemini Spark, Tenzo issues short-lived access tokens only — no refresh tokens. Once the access token expires, the client has to send the user back through the OAuth flow to get a new one. To stop a connector from talking to Tenzo, remove it from the client (Customize → Connectors in Claude, Settings → Plugins in ChatGPT, Connected Apps in Gemini); any in-flight token will stop working when it expires, and the client cannot mint a new one without going through consent again. Microsoft Copilot uses a confidential client that can refresh tokens, so revoke access by deleting the connection in Copilot Studio (or removing the connector from the agent).

Option 2 — `.mcp.json` with an API key (fallback)

Prefer the OAuth flow above whenever your client supports it — it needs no key and scopes access to your Tenzo login. Use this API-key method only when OAuth isn’t an option: a client that can’t do the remote OAuth flow, or a user or service without a Tenzo account authenticating with an API key instead. Local clients read MCP server definitions from a .mcp.json (or equivalent) config file. Add the following entry:

{
  "mcpServers": {
    "tenzo": {
      "type": "http",
      "url": "https://api.tenzo.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${TENZO_API_KEY}"
      }
    }
  }
}

Generate a Tenzo API key

Follow Generating an API Key to create a key in Settings → Developer Tools. Your key starts with tenzo_pk_.

Export the key

Export it as an environment variable so it stays out of your config file:

export TENZO_API_KEY=tenzo_pk_...

Add the entry to your client config

Claude Code — add to .mcp.json at the root of your project (or your global Claude Code config)
Cursor — ~/.cursor/mcp.json
Windsurf — ~/.codeium/windsurf/mcp_config.json
Claude Desktop — claude_desktop_config.json (see Anthropic’s docs for the platform-specific path)

Restart the client

Restart your MCP client. The Tenzo tools should appear in the client’s tool picker.

Treat your API key like a password. Anyone with the key has the same read access to your organization’s Tenzo data as you do. Revoke compromised keys from Settings → Developer Tools → API Keys.

Available tools

Every tool maps 1:1 to a GET endpoint in the Tenzo Public API. Click any tag link below to see the full request and response schemas for the underlying endpoint.

Analytics

Tool	Description	Public API
`get_analytics_metrics`	Analytics metrics and chart payloads for the dashboard	Analytics
`get_sourcing_by_user`	Sourced-candidate counts per recruiter	Analytics
`get_grading_analytics`	Per-question grading stats for a job	Analytics
`get_top_candidates_for_job`	Top-ranked candidates for a job	Analytics

Applications

Tool	Description	Public API
`list_applications`	List applications with filtering	Applicants
`get_application`	Get a single application by Tenzo or remote ID	Applicants
`get_application_by_candidate_and_job`	Resolve a (candidate, job) pair to its application	Applicants
`list_application_comments`	ATS comments on an application	Applicants
`get_application_communications_email`	Email history for an application	Applicants
`get_application_communications_sms`	SMS history for an application	Applicants

ATS

Tool	Description	Public API
`list_ats_integrations`	ATS integrations enabled for your org	ATS
`get_ats_integration_configuration`	Configuration for one integration	ATS
`list_ats_integration_rules`	Sync rules for an integration	ATS

Audit

Tool	Description	Public API
`list_audit_events`	Audit log events with filtering	Audit
`get_audit_event_filter_options`	Filter options for the audit log	Audit

Calls & interviews

Tool	Description	Public API
`list_calls`	List calls with filtering	Interviews, calls & media
`get_call`	Get a single call	Interviews, calls & media
`get_call_transcript`	Full call transcript	Interviews, calls & media
`get_call_quality_eval`	Quality-eval scores for a call	Interviews, calls & media
`search_interviews`	Search interviews by candidate, job, or status	Interviews, calls & media
`list_interview_results`	Structured interview-result rows	Interviews, calls & media
`get_interview_results`	Result rows for a single application	Interviews, calls & media

Candidates

Tool	Description	Public API
`list_candidates`	List candidates with filtering	Candidates
`get_candidate`	Get a single candidate	Candidates
`search_candidates`	Search candidates by name	Candidates
`get_candidate_resume`	Parsed resume for a candidate	Candidates
`list_candidate_notes`	ATS notes for a candidate	Candidates
`list_unanswered_candidate_questions`	Questions a candidate asked the AI that need a human reply	Candidates

Jobs

Tool	Description	Public API
`list_jobs`	List jobs with filtering	Jobs
`get_job`	Get a single job	Jobs
`search_jobs`	Rich job search with filters	Jobs
`get_job_settings`	Effective interview settings for a job	Jobs
`get_job_script`	Active script for a job	Jobs
`get_job_candidate_questions`	Candidate-facing FAQ for a job	Jobs
`get_job_resume_requirements`	Resume requirements configured for a job	Jobs

Folders

Tool	Description	Public API
`list_folder_contents`	Contents of a folder (jobs / sub-folders)	Jobs
`search_folders`	Search folders by name	Jobs

Media

Tool	Description	Public API
`list_media`	Audio/video assets metadata	Interviews, calls & media
`get_media_item`	A single media asset	Interviews, calls & media

Meeting Copilot

Tool	Description	Public API
`list_meeting_copilot_notes`	List Meeting Copilot notes for your org	Meeting Copilot
`get_meeting_copilot_note`	Get a single Meeting Copilot note	Meeting Copilot
`list_meeting_copilot_templates`	List Meeting Copilot templates (presets)	Meeting Copilot
`get_meeting_copilot_template`	Get a single Meeting Copilot template	Meeting Copilot

Docs

Tool	Description	Public API
`list_docs`	List doc paths in the public docs tree	Read-only Getters
`get_doc`	Get the markdown content of a doc	Read-only Getters

Organization & users

Tool	Description	Public API
`get_org_interview_settings`	Org-wide interview defaults	Organization
`get_interview_rules`	Active rules-engine rules	Organization
`list_users`	List users in your org	Read-only Getters
`get_user`	Get a single user	Read-only Getters
`search_users`	Search users by name	Read-only Getters

Templates

Two tools cover every org-template family. Pass the family via the kind parameter instead of calling a per-family tool. Both map to the Templates tag in the Public API.

Tool	Description	Public API
`list_templates`	List your org’s templates of a given `kind` (optional `name` substring filter)	Templates
`get_template`	Get one template by `kind` + `template_id`	Templates

Allowed kind values: script_generation, background_info, redaction, suggested_follow_up, voicemail_sms_prompt, flagged_event, summary, thank_you_email, custom_booking_outro, rejection_email, resume_feedback_email, interview_results_layout, question_constraints, work_accommodation_review.

The REST API keeps a dedicated endpoint per template family (e.g. GET /api/v1/templates/summary) — only the MCP tool surface is consolidated into list_templates / get_template.

Troubleshooting

401 Unauthorized from a .mcp.json client

Your API key is missing, expired, or revoked. Re-export TENZO_API_KEY with a fresh key from Settings → Developer Tools → API Keys and restart your MCP client.

A tool returns 403 Forbidden

The tool was called with an ID that belongs to a different organization. MCP tools only return data scoped to your org. Double-check the ID is one your account can see in the Tenzo dashboard.

A tool I expected isn't in the list

The MCP tools that proxy the Public API cover only its GET endpoints. Write operations on recruiting data (e.g. POST /api/v1/job) must be called via the REST API directly. (The assistant also has a submit_feedback tool that writes only to an internal feedback log, not to your recruiting data.)

API & Webhook Configuration — generate the API key used by .mcp.json clients
Tenzo Public API Documentation — full schemas for every underlying endpoint
Model Context Protocol specification — protocol details

Getting Started

Candidate Stage Lifecycle

Resume Review

Interview Settings

ATS Integrations

Workspace Integrations

Sourcing

Templates

User Management

Overview

Option 1 — OAuth connector (Claude, ChatGPT, Microsoft Copilot, Gemini Spark)

Claude (Claude.ai and Desktop)

ChatGPT

Microsoft Copilot

Gemini Spark (custom app)

Revoking access

Option 2 — `.mcp.json` with an API key (fallback)

Available tools

Analytics

Applications

ATS

Audit

Calls & interviews

Candidates

Jobs

Folders

Media

Meeting Copilot

Docs

Organization & users

Templates

Troubleshooting

​Overview

​Option 1 — OAuth connector (Claude, ChatGPT, Microsoft Copilot, Gemini Spark)

​Claude (Claude.ai and Desktop)

​ChatGPT

​Microsoft Copilot

​Gemini Spark (custom app)

​Revoking access

​Option 2 — .mcp.json with an API key (fallback)

​Available tools

​Analytics

​Applications

​ATS

​Audit

​Calls & interviews

​Candidates

​Jobs

​Folders

​Media

​Meeting Copilot

​Docs

​Organization & users

​Templates

​Troubleshooting

​Related

Overview

Option 1 — OAuth connector (Claude, ChatGPT, Microsoft Copilot, Gemini Spark)

Claude (Claude.ai and Desktop)

ChatGPT

Microsoft Copilot

Gemini Spark (custom app)

Revoking access

Option 2 — `.mcp.json` with an API key (fallback)

Available tools

Analytics

Applications

ATS

Audit

Calls & interviews

Candidates

Jobs

Folders

Media

Meeting Copilot

Docs

Organization & users

Templates

Troubleshooting

Related