MCP Integration

The Model Context Protocol (MCP) is an open standard by Anthropic that lets AI assistants (Claude, Cursor, Windsurf, etc.) connect to external services and call real tools. Datronis exposes an MCP server so any MCP-compatible AI can search jobs, browse news, explore companies, and query platform stats — all without writing a single line of integration code.

The MCP server is a single HTTP endpoint. All three HTTP methods are used by the protocol:

https://api.clarioscope.com/api/mcp

Add the following to your Claude Desktop configuration file. On macOS this is at ~/Library/Application Support/Claude/claude_desktop_config.json.

{
  "mcpServers": {
    "datronis": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://api.clarioscope.com/api/mcp"
      ]
    }
  }
}

These editors support HTTP MCP servers natively. Add the server URL in your editor's MCP settings panel:

{
  "mcpServers": {
    "datronis": {
      "url": "https://api.clarioscope.com/api/mcp",
      "type": "http"
    }
  }
}

All tools are public (no API key required). The AI can call them automatically based on your request.

The MCP server also exposes a readable resource — the platform overview documentation — which AI assistants can read to understand the platform before calling tools:

platform://docs/overview

The server uses the Streamable HTTP transport (MCP spec 2025-03-26):

• Step 1 — Client sends POST /api/mcp with an initialize message (no session ID header).
• Step 2 — Server creates a session and returns the Mcp-Session-Id header.
• Step 3 — All subsequent tool calls include the Mcp-Session-Id header.
• Step 4 — Client can open a GET /api/mcp SSE stream for server-initiated notifications.
• Step 5 — Client sends DELETE /api/mcp to close the session when done.
• Auto-expiry — Sessions auto-expire after 30 minutes of inactivity.

# Step 1: Initialize a session
curl -X POST https://api.clarioscope.com/api/mcp \
  -H "Content-Type: application/json" \
  -D - \
  -d '{"jsonrpc":"2.0","method":"initialize","id":1,"params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}'

# Note the Mcp-Session-Id in the response headers, then:

# Step 2: List available tools
curl -X POST https://api.clarioscope.com/api/mcp \
  -H "Content-Type: application/json" \
  -H "Mcp-Session-Id: <your-session-id>" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":2}'

# Step 3: Call search_jobs
curl -X POST https://api.clarioscope.com/api/mcp \
  -H "Content-Type: application/json" \
  -H "Mcp-Session-Id: <your-session-id>" \
  -d '{"jsonrpc":"2.0","method":"tools/call","id":3,"params":{"name":"search_jobs","arguments":{"q":"React","remote_type":"REMOTE","limit":5}}}'

The locale parameter in get_news and get_categories accepts a number from 1–18:

Once connected, try these natural language prompts in any MCP-aware AI:

• "Find remote senior React developer jobs in Europe"
• "What are the latest tech news articles in English?"
• "Search for fintech companies actively hiring in London"
• "How many jobs and companies are on the platform?"
• "Get the job details for slug 'senior-frontend-engineer-acme-corp'"
• "List all available news categories"