> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spott.io/llms.txt
> Use this file to discover all available pages before exploring further.

# The Spott MCP Server

> Connect AI assistants to Spott through the hosted MCP server and run your recruiting workflow from a conversation.

Spott provides a hosted **MCP (Model Context Protocol) server** at
`https://mcp.spott.io/mcp`. It exposes a set of tools that AI assistants can call to
work in Spott on your behalf: searching records, creating candidates, moving
applications, scheduling interviews, sending emails, logging calls, and more.

## What it's for

* Run your day-to-day recruiting workflow from a chat conversation.
* Build assistant-driven automations that read and write Spott data.
* Connect Spott into multi-step agentic flows alongside other connectors.

## Set it up

The quickest paths are our step-by-step guides:

<CardGroup cols={2}>
  <Card title="Use Spott in Claude" icon="robot" href="/docs/developers/claude">
    Connect Spott in Claude apps, or add it as a custom connector.
  </Card>

  <Card title="Use Spott in ChatGPT" icon="comments" href="/docs/developers/chatgpt">
    Add Spott as an app in ChatGPT with the MCP server URL.
  </Card>
</CardGroup>

For any other MCP-capable tool, the general flow is:

1. Add a **custom connector** and point it at `https://mcp.spott.io/mcp`.
2. Connect. The tool redirects you to a Spott OAuth page.
3. Approve access. The assistant can now make authenticated calls on your behalf.

## Authentication: OAuth, per user

Unlike the [REST API](/docs/developers/api-overview), which uses API keys, the MCP
server authenticates with **OAuth**:

* Each user connecting completes their own OAuth flow; access is scoped to that user.
* Actions the assistant performs are attributed to the connected user.
* No keys to paste or rotate, and access can be revoked from the Spott side.

## What the assistant can do

The tool set grows over time and reflects the live capability surface: searching and
looking up records, creating and updating candidates, managing applications and
pipelines, notes, tasks, emails, calendar invites, placements, and more. After
connecting, ask your assistant what Spott tools it has available for the current
list.

## MCP vs the API vs webhooks

* **MCP**: AI-assistant-driven interactions and agentic flows.
* **REST API**: traditional integrations and programmatic data access at scale.
* **Webhooks**: event-driven notifications from Spott to your systems.

The three are complementary and can be combined.