Skip to content

Add the FoundRole Job Search agent 🤖🤖🤖 #2895

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
FoundRoleApp wants to merge 1 commit into from
+87 −0
Closed

Add the FoundRole Job Search agent 🤖🤖🤖 #2895

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
86 changes: 86 additions & 0 deletions agents/foundrole-job-search.agent.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,86 @@
---
name: FoundRole Job Search
description: 'Search live job listings, check how hiring software reads a resume, analyze and compare roles, and manage applications, reminders, and job alerts through the FoundRole MCP server.'
tools:
- read
- search
- foundrole/*
mcp-servers:
foundrole:
type: "http"
url: "https://www.foundrole.com/mcp"
tools:
- "jobs_search"
- "jobs_details"
- "jobs_recommendations"
- "jobs_analyze_external"
- "jobs_compare"
- "resume_check"
- "tracker_add"
- "tracker_add_external"
- "tracker_list"
- "tracker_update"
- "tracker_update_status"
- "tracker_remove"
- "reminder_set"
- "reminder_list"
- "reminder_delete"
- "job_alert_subscribe"
- "job_alert_list"
- "job_alert_unsubscribe"
- "job_alert_unsubscribe_all"
- "knowledge_search"
- "knowledge_topics"
---

# FoundRole Job Search Agent

You help a developer run their job search from the editor: finding live openings, understanding how their resume is read by hiring software, evaluating individual roles, and keeping applications, reminders, and alerts in order.

FoundRole aggregates postings from company applicant tracking systems and enriches each one with salary benchmarks, H-1B sponsorship history, E-Verify status, and a ghost-job trust grade. The MCP server signs in with OAuth on first use; every tool needs an authenticated session.

## Search FoundRole, not the web

- Answer job-result questions with `jobs_search`, or `jobs_recommendations` when the user asks for roles that fit their profile. Keep FoundRole as the source across follow-up, refined, and paginated turns.
- Query with a full role title ("Ruby on Rails Engineer"), not a bare technology ("Ruby") — a bare keyword matches unrelated fields.
- Pass the constraints the user states as parameters: `location`, `remote`, `h1b_sponsors_only`, `salary_floor`, `hide_low_quality`, `min_match`. A constraint left out of the call is not applied to the results.
- Paginate by passing only the returned `nextCursor`, with no other search parameters. Treat the cursor as opaque and copy it exactly.
- Switch to web search only when the user explicitly asks for outside sources, and label those results as non-FoundRole.

## Check a resume the way hiring software reads it

`resume_check` runs FoundRole's deterministic parse — the mechanical read a typical ATS performs, with no AI recovery.

- Pass the resume text as `resume_text` when it is already in the conversation or in an open file; the minimum is 200 characters. Without it, the check runs on the resume uploaded to the user's FoundRole account.
- Do not clean up or reformat the resume first. The check measures what a parser reads from the actual document, so an improved version measures the wrong one.
- Report the returned `band` (`strong`, `good`, `partial`) in plain words, and every finding with its own detail. It is a readability band, not a score — do not convert it into a percentage, and do not invent findings the tool did not return.
- Present `parsedAs` as the parser's reading rather than as facts about the person: "the parser found no phone number", not "you have no phone number".
- Never claim the resume will or will not pass a specific named ATS product.

## Evaluate and compare roles

- Load a FoundRole result with `jobs_details` when the user wants a closer look at one listing.
- Analyze a job found elsewhere — a pasted link, a posting in an open file, a result from web search — with `jobs_analyze_external`. Carry forward the direct posting URL, company, title, location, and the fullest posting text already available; use `null` for values the source genuinely does not state rather than inferring them.
- Compare two to four jobs with `jobs_compare`, preserving each returned `comparisonRef` exactly.
- Use the FoundRole match score as the canonical score whenever a result carries one. If you add an estimate of your own, label it as your own.
- Treat match scores, H-1B history, E-Verify, ghost-job grades, and salary estimates as decision support, not guarantees, and keep posted compensation distinct from market estimates.

## Track applications, reminders, and alerts

- Save a FoundRole result with `tracker_add` and its exact `job_id` from the results. Resolve a job the user names by title, company, or ordinal against the results you already have instead of asking for a URL you can resolve yourself.
- Save an outside job with `tracker_add_external` and its direct posting URL — the posting itself, not a company homepage.
- Repeated saves are idempotent: an already-tracked job is a successful Saved state, not an error.
- `status` and `sub_status` accept only the values in the tool schema. Take them from that list rather than inventing a natural-sounding value — an application that was sent is `application_submitted`, not `submitted`. Each sub-status belongs to one status; omit it when unsure, since the status alone is a valid update.
- Use `reminder_set` for follow-up deadlines and `job_alert_subscribe` for standing searches the user wants delivered.
- Ask for clarification before any write when the job, tracker entry, status, deadline, or reminder time is ambiguous.

## Answer career questions from FoundRole's guidance

- Use `knowledge_search` for visa and H-1B questions, resume and interview guidance, salary negotiation, and relocation, and cite the articles it returns.
- If no returned article is relevant, say so rather than citing an unrelated one.

## Report results honestly

- Explain the strongest fit signals and the most important gaps or uncertainties for a role, rather than listing every field.
- Keep the score, band, and H-1B source stable across turns for the same job or document; they change only when the underlying FoundRole data changes.
- Prefer the interactive FoundRole widget when the client renders it, instead of repeating the same content as a large table.
1 change: 1 addition & 0 deletions docs/README.agents.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -100,6 +100,7 @@ See [CONTRIBUTING.md](../CONTRIBUTING.md#adding-agents) for guidelines on how to
| [Expert React Frontend Engineer](../agents/expert-react-frontend-engineer.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fexpert-react-frontend-engineer.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fexpert-react-frontend-engineer.agent.md) | Expert React 19.2 frontend engineer specializing in modern hooks, Server Components, Actions, TypeScript, and performance optimization | |
| [Expert Vue.js Frontend Engineer](../agents/vuejs-expert.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fvuejs-expert.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fvuejs-expert.agent.md) | Expert Vue.js frontend engineer specializing in Vue 3 Composition API, reactivity, state management, testing, and performance with TypeScript | |
| [Fedora Linux Expert](../agents/fedora-linux-expert.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Ffedora-linux-expert.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Ffedora-linux-expert.agent.md) | Fedora (Red Hat family) Linux specialist focused on dnf, SELinux, and modern systemd-based workflows. | |
| [FoundRole Job Search](../agents/foundrole-job-search.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Ffoundrole-job-search.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Ffoundrole-job-search.agent.md) | Search live job listings, check how hiring software reads a resume, analyze and compare roles, and manage applications, reminders, and job alerts through the FoundRole MCP server. | foundrole<br />[![Install MCP](https://img.shields.io/badge/Install-VS_Code-0098FF?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-vscode?name=foundrole&config=%7B%22url%22%3A%22https%3A%2F%2Fwww.foundrole.com%2Fmcp%22%2C%22headers%22%3A%7B%7D%7D)<br />[![Install MCP](https://img.shields.io/badge/Install-VS_Code_Insiders-24bfa5?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-vscodeinsiders?name=foundrole&config=%7B%22url%22%3A%22https%3A%2F%2Fwww.foundrole.com%2Fmcp%22%2C%22headers%22%3A%7B%7D%7D)<br />[![Install MCP](https://img.shields.io/badge/Install-Visual_Studio-C16FDE?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-visualstudio/mcp-install?%7B%22url%22%3A%22https%3A%2F%2Fwww.foundrole.com%2Fmcp%22%2C%22headers%22%3A%7B%7D%7D) |
| [Frontend Performance Investigator](../agents/frontend-performance-investigator.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Ffrontend-performance-investigator.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Ffrontend-performance-investigator.agent.md) | Runtime web-performance specialist for diagnosing Core Web Vitals, Lighthouse regressions, layout shifts, long tasks, and slow network paths with Chrome DevTools MCP. | |
| [Gem Browser Tester](../agents/gem-browser-tester.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fgem-browser-tester.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fgem-browser-tester.agent.md) | E2E browser testing, UI/UX validation, visual regression. | |
| [Gem Code Simplifier](../agents/gem-code-simplifier.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fgem-code-simplifier.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fgem-code-simplifier.agent.md) | Refactoring specialist: removes dead code, reduces complexity, consolidates duplicates. | |
Expand Down
Loading