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 one of the most capable public MCP servers in the job-search space: any MCP-compatible AI can search real jobs, browse news, explore companies, and query live platform stats for free — and, with a personal access token, build or update a full resume from nothing but a conversation, submit job applications, and check application status, all on your behalf and 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.datronis.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.datronis.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.datronis.com/api/mcp",
      "type": "http"
    }
  }
}

아래 처음 6개 도구는 공개 도구입니다(API 키 불필요) — AI가 요청에 따라 자동으로 호출할 수 있습니다. 나머지 5개는 개인 액세스 토큰이 필요합니다(다음 섹션 참조). 지원서 제출, 이력서 읽기, 지원 내역 확인, 뉴스 기사 초안 작성 또는 수정 등 사용자 계정에서 동작하기 때문입니다.

MCP를 통한 뉴스 게시는 고정된, 우회할 수 없는 워크플로우를 따릅니다: 영어로 초안 작성, 분류, 그 후에야 게시 여부와 다른 어떤 언어로 게시할지 결정합니다.

• 1단계 — 영어 초안 — draft_news는 최종적으로 어떤 언어로 게시하고 싶든 관계없이 항상 기사의 영어 버전을 먼저 만듭니다. 분류와 모든 검토는 이 영어 버전을 진실의 원천으로 삼습니다.
• 2단계 — 자동 분류 — AI 안전 분류기가 기사를 읽고 'green'(논란의 여지가 없는 것 — 과학, 기술, 비즈니스, 스포츠, 엔터테인먼트, 문화, 건강, 라이프스타일) 또는 'flagged'(당파적 정치, 선거, 전쟁이나 분쟁, 노골적인 폭력, 혐오 발언, 허위 정보, 또는 일반 대중에게 논란이 되거나 분열을 일으킬 가능성이 있는 모든 것)를 반환합니다.
• green인 경우 — 기사는 즉시 영어로 게시되며 target_locales에 나열한 모든 로케일로도 번역되어 게시됩니다.
• flagged인 경우 — 기사는 생성되지만 게시되지 않은 상태로 유지됩니다. 도구 호출은 분류기의 근거를 반환합니다. draft_news에 전달할 수 있는 어떤 것도 여기서 게시를 강제하지 않습니다 — 우회 플래그는 없습니다.
• 3단계 — 검토 및 재제출(선택 사항) — 동일한 news_id와 수정된 제목/본문으로 resubmit_news를 호출하세요. 이는 수정본에 대해 완전히 새로운 분류를 트리거하며 원본과 별개의 독립된 시도로 기록됩니다. 수정본이 이제 green이면 게시되고, 여전히 flagged라면 게시되지 않은 상태로 남아 다시 제출할 수 있습니다.
• 소유권 — 특정 기사에 대해 처음 draft_news를 호출한 api_key를 가진 계정만 그 기사에 resubmit_news를 호출할 수 있습니다. 다른(유효한 것이라도) api_key는 거부됩니다.
• 언어는 선택 사항 — target_locales를 생략하면 영어로만 게시됩니다. 원하는 2글자 언어 코드(예: ["de", "ru"])를 전달하면 같은 호출에서 해당 언어로도 번역 및 게시됩니다.
• Flexible authoring — set content_format to markdown for headings, tables, lists, links, images and code blocks, or html for rich HTML, classes and inline CSS. Markdown is converted to stable HTML on the backend before storage, translation and indexing.

apply_to_job, list_my_resumes, create_resume, update_resume, get_my_applications, draft_news, resubmit_news, submit_news_translation, and all admin_* tools act on your Datronis account, so they need to know who you are. Generate a personal access token from your account settings, then send it either as an Authorization: Bearer HTTP header (preferred) or as the api_key argument on the tool call.

• Step 1 — Go to /app/api-keys/ while logged in and click "New Key".
• Step 2 — Copy the generated key (starts with dtk_) — it's shown only once.
• Step 3 (preferred) — Configure your MCP client to send Authorization: Bearer dtk_... as an HTTP header on every request.
• Step 3 (fallback) — If your client can't set custom headers, pass it as api_key in your prompt or tool call instead, e.g. "apply to job X using api_key dtk_...".
• Revoking — Revoke a key anytime from the same page; it stops working immediately, regardless of which method was used to send it.

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). Every request, including this first one, must send Accept: application/json, text/event-stream — the server rejects anything else with 406 Not Acceptable.
• Step 2 — Server creates a session and returns the Mcp-Session-Id header.
• Step 3 — Client sends a notifications/initialized message (with the Mcp-Session-Id header) to confirm the handshake — the spec-correct next step, expected by well-behaved MCP clients even though this server doesn't currently enforce it.
• Step 4 — All subsequent tool calls include the Mcp-Session-Id header.
• Step 5 — Client can open a GET /api/mcp SSE stream for server-initiated notifications.
• Step 6 — 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.datronis.com/api/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -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: Confirm initialization (expected: 202 Accepted, empty body)
curl -X POST https://api.datronis.com/api/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Mcp-Session-Id: <your-session-id>" \
  -d '{"jsonrpc":"2.0","method":"notifications/initialized"}'

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

# Step 4: Call search_jobs
curl -X POST https://api.datronis.com/api/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -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}}}'

get_news와 get_categories의 locale 매개변수는 1에서 24까지의 숫자를 받습니다. draft_news/resubmit_news는 대신 target_locales에서 2글자 코드(예: "de", "ru")를 사용합니다 — 이 표에 표시된 것과 동일한 코드입니다.

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"
• "Apply to the senior-frontend-engineer-acme-corp job using my Datronis account (api_key dtk_...)"
• "List my resumes on Datronis and tell me which one is my default"
• "Build me a Datronis resume from my background: 4 years as a backend engineer at Acme (2021-present), B.Sc. Computer Science from TU Berlin, strong in Go and PostgreSQL (api_key dtk_...)"
• "Datronis에 [주제]에 관한 뉴스 기사를 초안 작성하고 영어와 독일어로 게시해줘 (api_key dtk_...)"
• "내 마지막 draft_news 호출이 flagged 되었어 — 여기 수정되고 중립적인 버전이 있어, news_id 123으로 다시 제출해줘"
• "Draft a news article on Datronis about [topic] and publish it in English and German (api_key dtk_...)"
• "My last draft_news call was flagged — here's a revised, neutral version, resubmit it under news_id 123"
• "Which published articles on Datronis are still missing a Finnish translation?"
• "Translate news_id 101 into Finnish and publish it using my api_key"