Koskamo

Refine MCP MCP server

Refine is an official job search MCP server that allows AI assistants to manage the operational aspects of a job search. It enables users to track applications, monitor company signals, manage recruiter communications, organize interview details, and record offer information. The server provides a durable record of job search activities and integrates with compatible AI clients via a hosted Streamable HTTP endpoint with OAuth authorization.

Endpoint and access

No sign-in: your client connects and lists tools immediately, with no account or key.

No sign-inEndpoint checked 2026-10-05Operated by Refine
MCP endpoint (Streamable HTTP)
https://mcp.getrefine.co/mcp
Vendor documentation

What you can do with it

  • Track active job applications and identify those needing follow-up
  • Monitor company career pages for new openings matching preferences
  • Prepare for interviews using job details and personal notes
  • Draft replies to recruiter emails without sending them immediately
Tools advertised by the last live check:
  • jobs.list
  • jobs.get
  • jobs.add
  • jobs.update
  • jobs.delete
  • jobs.refresh
  • jobs.mark_applied
  • jobs.archive
  • jobs.unarchive
  • jobs.interviews.add
  • jobs.interviews.update
  • jobs.interviews.delete
  • jobs.offer.create
  • jobs.offer.update
  • jobs.offer.delete
  • jobs.offer.accept
  • jobs.offer.decline
  • jobs.offer.add_negotiation
  • jobs.offer.delete_negotiation
  • signals.list
  • signals.track
  • signals.update
  • signals.untrack
  • signals.pause
  • signals.resume
  • signals.openings.save
  • signals.list_applied_jobs
  • signals.openings.list
  • signals.openings.mark_read
  • signals.openings.mark_all_read
  • inbox.list
  • inbox.get
  • inbox.get_thread
  • inbox.draft_reply
  • inbox.send_reply
  • inbox.apply_suggestion
  • inbox.undo
  • inbox.mark_read
  • inbox.unsubscribe
  • inbox.dismiss
  • inbox.acknowledge
  • inbox.decline
  • inbox.refresh
  • inbox.sync_status
  • persona.get
  • signals.recommendations.list
  • signals.recommendations.get
  • signals.recommendations.watch
  • signals.recommendations.dismiss
  • signals.recommendations.block
  • signals.recommendations.restore
  • signals.recommendations.feedback
  • account.agenda
  • integrations.list
  • integrations.connect_google

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers a Streamable HTTP server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http refine-mcp https://mcp.getrefine.co/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add refine-mcp --url https://mcp.getrefine.co/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable refine-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "refine-mcp": {
      "url": "https://mcp.getrefine.co/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure). The type must be streamableHttp for a remote HTTP server.
Cline configuration
{
  "mcpServers": {
    "refine-mcp": {
      "type": "streamableHttp",
      "url": "https://mcp.getrefine.co/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start refine-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "refine-mcp": {
      "type": "http",
      "url": "https://mcp.getrefine.co/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http refine-mcp https://mcp.getrefine.co/mcp

Claude Desktop

Merge this into claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\), then restart Claude Desktop.
Claude Desktop configuration
{
  "mcpServers": {
    "refine-mcp": {
      "url": "https://mcp.getrefine.co/mcp"
    }
  }
}

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "refine-mcp": {
      "serverUrl": "https://mcp.getrefine.co/mcp"
    }
  }
}

Do you run Refine MCP?

Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.

Claim this listing