Skip to main content

Documentation Index

Fetch the complete documentation index at: https://api-docs.spott.io/llms.txt

Use this file to discover all available pages before exploring further.

ChatGPT users — read first. The way ChatGPT currently connects to MCP servers requires a quick manual setup on our side before authentication will go through. Go ahead and configure the connector as normal, but expect the sign-in step to fail on first attempt — this is normal. Once the connector is added, contact our customer support team so we can enable and finalize your connection. You’ll be able to authenticate successfully once we confirm, usually within one business day. Other clients like Claude and Cursor work out of the box.
The Spott connector for ChatGPT lets recruiters work in Spott directly from a ChatGPT conversation. ChatGPT can search your candidates, jobs, and companies, move applications through your pipeline, schedule interviews, log calls and notes, send emails, parse CVs, and close placements — all scoped to the authenticated user’s tenant and reflected back in the Spott UI in real time.
The connector exposes tools only — there is no separate Spott workspace inside ChatGPT. Every action runs against your live Spott account, and respects the same permissions you have in the Spott UI.

​
Prerequisites

  • An active Spott workspace with a paid subscription
  • A Spott user account with the permissions you’d normally use in the Spott UI
  • A ChatGPT account on any plan (Free, Go, Plus, Pro, Business, Enterprise, or Education)

​
Connect Spott to ChatGPT

Creating a custom MCP connection is currently only supported in the web version of ChatGPT and is not available in the desktop or mobile apps.
1

Enable Developer Mode

In ChatGPT, click your profile icon in the bottom-left corner and open Settings. From there, navigate to Apps → Advanced settings and enable Developer mode.
Chatgpt Mcp Dev Mode
1

Create a New App

Once Developer mode is enabled, go to Settings → Apps and click Create app. You can choose any name for the app, but we recommend using Spott MCP for clarity. In the MCP Server URL field, enter https://mcp.spott.io/mcp, and set the Authentication method to OAuth. After reviewing the configuration, confirm by selecting the “I understand and want to continue” checkbox, then click Create to finish setting up the app.
Chatgpt Mcp Setup
1

Contact Support

At this point, the app will be created successfully, but it will not function yet. Contact the Spott support team to enable and finalize the MCP connection for your account.
1

Connect the App

Once you have received confirmation that your account has been set up, go back to Settings → Apps → Spott and click Connect.
Chatgpt Mcp Connect
This will bring you to an authentication screen where you need to grant access. If this page does not load correctly, clear the cookies on app.spott.io and try again.
Chatgpt Mcp Auth
1

Enable for your conversation

Click + → **More **→ Spott MCP in your chat to enable the Spott connector for this conversation.
Chatgpt Mcp Enable

​
What you can do

You can use the Spott connector to:

Search candidates, jobs & companies

“Find Python engineers in Brussels with 5+ years of experience”

Manage applications & pipeline

“Move Emma to the offer stage and email her the offer letter”

Schedule interviews

“Book a 30-minute intro between Mario and Dimitri from Forum Jobs tomorrow at 2pm”

Log calls, notes & activity

“Log a call with John yesterday — 3 month notice, €85k, available next week”

Parse CVs & enrich candidates

“Create a candidate from this CV and enrich their email and LinkedIn”

Place candidates & close deals

“Place Sarah at Google as Senior PM, start date Feb 1, 25% fee”

​
Permissions and data scope

The Spott connector respects every permission and role configured in your Spott workspace. ChatGPT can only see and modify records you have access to in the Spott UI.
  • Tenant isolation: Each user authenticates with their own Spott credentials. ChatGPT never sees data outside your tenant.
  • Read and write: The connector includes both read tools (search, lookup, activity) and write tools (create, update, send). Write tools with external side effects (sending emails, scheduling interviews, placing candidates) are flagged so ChatGPT treats them with extra care.
  • Confirmation for high-impact actions: ChatGPT will confirm with you before sending external communications or making irreversible changes like placing a candidate or rejecting an application.

​
Troubleshooting

Disconnect and reconnect Spott from ChatGPT → Settings → Apps. Clear cookies for app.spott.io if the issue persists. If your workspace uses SSO, make sure your identity provider session is active before connecting.
Make sure the Spott connector is enabled for the current conversation (+ → More).
The Spott MCP enforces the same permissions as the Spott UI. If you can’t see a record in Spott itself, ChatGPT can’t either. Ask your workspace admin to grant the required role.
spott_schedule_interview schedules an interview against an existing application. If the candidate doesn’t have an application on the relevant job yet, create the application first (for example: “Add Mario as an applicant on the Forum Jobs Senior Backend role”) and try again.
spott_place_candidate advances an existing application to the placed stage. The candidate must already be on a job’s pipeline. If they aren’t, create the application first.

​
Privacy and security

  • Spott is hosted in the EU and is GDPR-compliant.
  • Customer data is never used to train AI models.
  • All data is encrypted in transit (TLS) and at rest.
  • A Data Processing Agreement (DPA) is available on request.
For full details, see the Spott Privacy Policy.

​
Support

Email support

support@spott.io

Spott documentation

docs.spott.io
For ChatGPT-specific connector questions, see OpenAI’s connectors help.