Find your role first
RemoteAbout Find your role first
Find your role first is a job-search MCP server for job seekers and their agents. It reads company career sites directly, orders roles by when they first appeared, and also supports saving, tracking, and email alerts.
Key features
- 01Search and filter roles
- 02Count matching search results
- 03Check new roles matching preferences
- 04Save roles and update application status
- 05Set company and job email alerts
Use cases
- 01Find jobs by title, location, and posting time
- 02Check new matching roles each morning
- 03Save target roles and track application progress
- 04Get email when followed companies post roles
MCP support
The MCP server exposes tools for searching, counting, saving, tracking, and setting alerts for jobs. It draws on company career-site data and returns role details with original posting links.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://findyourrolefirst.click/mcpclaude mcp add --transport http click-findyourrolefirst-jobfeed https://findyourrolefirst.click/mcp{"mcpServers":{"click-findyourrolefirst-jobfeed":{"type":"http","url":"https://findyourrolefirst.click/mcp"}}}Open in Cursor{"servers":{"click-findyourrolefirst-jobfeed":{"type":"http","url":"https://findyourrolefirst.click/mcp"}}}Open in VS Code{"mcpServers":{"click-findyourrolefirst-jobfeed":{"type":"http","url":"https://findyourrolefirst.click/mcp"}}}{"mcpServers":{"click-findyourrolefirst-jobfeed":{"serverUrl":"https://findyourrolefirst.click/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
https://findyourrolefirst.click/mcpAuth requiredTools
Details
From the project READMEJob search MCP server
New jobs from more than 15,000 company career sites, for Claude Code, Codex and any MCP client.
Find your role first reads company career sites directly (Greenhouse, Lever, Ashby and Workday boards, plus Amazon, Apple, Google, Meta, Microsoft and Netflix) every two to six hours, and records the hour each role first appeared. This server lets your AI agent search those roles, newest first, and come back each morning for what's new.
No job boards in between, no reposts posing as new roles. Every result links to the company's own posting and application.
Also listed on Smithery and the official MCP Registry (click.findyourrolefirst/jobfeed).
See it without signing up: new jobs posted in the last 24 hours, by role, updated every few hours.
Connect
You need an agent key from your console. Replace YOUR_API_KEY below.
Claude Code
claude mcp add --transport http --scope user jobfeed https://findyourrolefirst.click/mcp --header 'Authorization: Bearer YOUR_API_KEY'
Codex CLI
export JOBFEED_API_KEY=YOUR_API_KEY
codex mcp add jobfeed --url https://findyourrolefirst.click/mcp --bearer-token-env-var JOBFEED_API_KEY
Any HTTP MCP client
{
"mcpServers": {
"jobfeed": {
"type": "http",
"url": "https://findyourrolefirst.click/mcp",
"headers": { "Authorization": "Bearer YOUR_API_KEY" }
}
}
}
Tools
| Tool | What it does |
|---|---|
search_jobs | Search open roles by several titles and places at once, newest first. Filters for remote, posted within N hours, and the years of experience a posting asks for. Each result says whether you saved it. |
count_jobs | How many roles a search would return. Free, so your agent can narrow before it reads. |
get_new_for_me | Roles matching your saved preferences found since the last check. |
get_my_profile | What you said you want (fields, places, experience), plus the companies you follow and your email alerts. |
get_apply_kit | The apply link, the application form's questions when the site publishes them, and the role's facts. The service never applies; your agent can, if you ask it to. |
get_changes | New, updated, reopened and closed roles since your last check. The "what's new since yesterday" call. |
get_job | One role's latest details and status. |
list_my_jobs | Roles you've already seen, with whether each is saved and where it stands. saved_only lists your Saved tab; assigned_to lists the roles you tagged for one agent. Free. |
save_job / unsave_job | Put a role on your Saved tab, or take it off. Free. |
set_job_status | Mark a role applied, interview, offer or closed. A week after applied with no change, your daily email asks whether to follow up. Free. |
follow_company / unfollow_company | An email within about 15 minutes when a company posts a new role. Up to 25 companies. Free. |
create_alert / delete_alert | Email yourself new roles matching a search, instantly or once a day. Up to 5. Free. |
get_usage | Your remaining allowance. |
Every write takes agent, the agent's own name. Your roles in the console tags each role with who saved or marked it ("Saved by Fo"), and you can filter and rename those tags.
Records carry title, company, location, posted and first-seen dates, and the original posting and apply links. No description text: your agent opens the posting itself when it needs the details.
Ask it things like
- "Find product manager roles in New York posted in the last 24 hours."
- "Any new forward deployed engineer jobs since yesterday? Skip senior and staff."
- "Count remote data scientist roles asking for 1 to 3 years of experience, then show me the newest ten."
- "Check what's new every morning and list anything at a company I haven't seen before."
Pricing
- Free: sign in and search 200 roles in your first 30 days, then 100 a month, in the web console.
- $9 a month: 3,000 new roles a month (up to 1,000 a day) and agent access through this MCP server. Re-reading a role you've already seen that month is free. Cancel anytime.
Links
- Live: new jobs by role
- Docs: tools, fields, REST API and limits
- How to find jobs posted in the last 24 hours
- Tools that pull jobs straight from company career pages
Questions or a company we're missing: [email protected]
Agent skill
A ready-made skill that tells an agent when and how to use these tools (daily checks, searches, apply kits, and applying only to roles you hand it): skills/find-your-role-first/SKILL.md.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.