ITJobs MCP

Connect your AI assistant to your ITJobs candidate account: search jobs and companies, see your applications and apply

Not a developer? See the step-by-step guide.

Endpoint

MCP server URL: https://www.itjobs.pt/mcp
Healthcheck URL: https://www.itjobs.pt/mcp/health

Connecting

You need an ITJobs candidate account. Add the server URL to your assistant; when it connects, it opens the ITJobs sign-in and asks you to authorize it. There is no API key to copy.

Claude (claude.ai and Claude Desktop): Settings → Connectors → Add custom connector, URL https://www.itjobs.pt/mcp, then Connect.
ChatGPT: Settings → Connectors (developer mode) → add a connector with the same URL.
Claude Code: claude mcp add --transport http itjobs https://www.itjobs.pt/mcp, then /mcp to sign in.
Other MCP clients: any client that supports remote servers with OAuth.

You can see and disconnect the apps connected to your account in your profile, under Connected apps. Changing your password disconnects all of them.

Tools

Tool	What it does	Scope
`job_search`	Search jobs by text, with location, type, contract, salary and remote filters	`jobs:read`
`job_list`	Latest jobs, with the same filters	`jobs:read`
`job_get`	One job, in full	`jobs:read`
`company_search`, `company_get`	Search companies, one company	`jobs:read`
`location_list`, `contract_list`, `job_type_list`	The ids used by the filters	`jobs:read`
`me`	Your name, language and whether your CV is ready to apply with	`profile:read`
`my_cv`	Your CV on ITJobs: about you, nationality, job preferences, experience, education, certifications and skills - no contacts	`cv:read`
`my_applications`	Your applications: date, job, company and whether the company has seen it	`applications:read`
`job_apply`	Apply to a job with the CV you have on ITJobs and a message the assistant writes - your assistant asks you before sending	`applications:write`

job_apply only works for jobs that take applications through ITJobs: for jobs on the company's own site it returns that address, and without a CV on file it returns the link to upload one. Up to 20 applications a day through assistants.

For developers

Streamable HTTP: POST https://www.itjobs.pt/mcp, JSON-RPC 2.0, MCP protocol 2025-06-18 (also 2025-03-26, 2024-11-05).
Every request needs Authorization: Bearer <access token>; without it the answer is 401 with WWW-Authenticate pointing to https://www.itjobs.pt/.well-known/oauth-protected-resource/mcp. A token without the tool's scope gets 403.
OAuth 2.1 with PKCE and dynamic client registration - endpoints and details in auth.md.
GET /mcp returns this page; OPTIONS /mcp is supported for preflight.

curl -si -X POST "https://www.itjobs.pt/mcp" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize"}'
# HTTP 401 + WWW-Authenticate: Bearer resource_metadata="https://www.itjobs.pt/.well-known/oauth-protected-resource/mcp"