← Back to search

MCP Server Documentation

Model Context Protocol API for AI Assistants

What is MCP?

The Model Context Protocol (MCP) is an open standard that allows AI assistants to connect to external data sources. Our MCP server lets AI tools like Claude, ChatGPT, and Cursor search consultant jobs in Sweden directly.

Instead of manually searching job boards, you can ask your AI assistant to find relevant positions for you.

Getting Started

Connect your AI assistant using our server URL:

https://mcp.consultant.dev/mcp

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "consultant-jobs": {
      "url": "https://mcp.consultant.dev/mcp"
    }
  }
}

Claude.ai

In Claude.ai settings, add the MCP server URL. You will be prompted to sign in with your Consultant.dev account when connecting.

Cursor

Add to your Cursor MCP settings:

{
  "mcpServers": {
    "consultant-jobs": {
      "url": "https://mcp.consultant.dev/mcp"
    }
  }
}

VS Code (Copilot)

Add to settings.json:

{
  "mcp.servers": {
    "consultant-jobs": {
      "url": "https://mcp.consultant.dev/mcp"
    }
  }
}

Available Tools

search_assignments

Search for consultant assignments with filters.

  • query - Search query for job title, description, or skills
  • location - City or region (e.g., Stockholm, Göteborg)
  • role - Filter by job role
  • seniority - junior, regular, senior, or lead
  • skills - Array of required skills
  • limit - Results per page (max 20)

get_assignment

Get full details of a specific job by its ID.

  • id - The job/assignment ID

get_filter_options

Get available filter options (roles, locations, seniority levels, etc.).

list_recent_assignments

Get the most recently posted consultant assignments.

  • limit - Number of jobs to return (max 20)

get_related_assignments

Find similar assignments based on a given job ID.

  • id - The assignment ID to find similar jobs for
  • limit - Number of similar jobs to return (max 10)

mark_applied

Mark an assignment as applied to track your applications.

  • assignment_id - The assignment ID you applied to

list_applied

List all assignments you have marked as applied.

  • limit - Maximum number of applications to return (max 50)

Authentication

All API tools require OAuth authentication. When you first connect your AI assistant to the MCP server, you will be prompted to sign in with your Consultant.dev account.

This enables personalized features like application tracking and ensures secure access to the job search API.

Example Usage

Once connected, you can ask your AI assistant things like:

  • "Find backend developer jobs in Stockholm"
  • "Show me senior React positions in Göteborg"
  • "What are the newest consultant assignments?"
  • "Get details for job ID abc123"
  • "Mark this job as applied"

Contact

Questions or issues? Contact us at contact@consultant.dev