# Find your role first

> New jobs from 15,000+ company career sites, newest first, for Claude Code, Codex and any agent.

- name: click.findyourrolefirst/jobfeed
- version: 1.0.3
- connection class: R2 (oauth_consent_once)
- trust: 95/100
- quality: 86/100 (good)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/click.findyourrolefirst%2Fjobfeed
- tools: https://api.protogrid.dev/v1/servers/click.findyourrolefirst%2Fjobfeed/tools

**An agent can connect after a one-time OAuth consent by a human.** Remote endpoint behind OAuth 2. Tokens stay with the agent; the registry only exposes the authorization metadata.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "jobfeed": {
      "type": "http",
      "url": "https://findyourrolefirst.click/mcp",
      "headers": {
        "Authorization": "Bearer ${JOBFEED_TOKEN}"
      }
    }
  }
}
```

Placeholders to fill: `${JOBFEED_TOKEN}`.

## Trust

- hygiene: 100
- liveness: 99
- freshness: 100
- provenance: 85
- drivers: +repository +dns-namespace +website +reachable +uptime-98% +updated-13d-ago
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 86/100 (good)

### protocol: n/a (weight 25)

- n/a `protocol.modern`, `protocol.stateless`, `protocol.transport`, `protocol.list_ttl`: no remote answered a protocol handshake (not probed yet, unreachable, or local-only)

### authorization: 83 (weight 15)

- pass `auth.prm`: Protected Resource Metadata (RFC 9728) published
- pass `auth.as_metadata`: authorization server metadata reachable
- warn `auth.cimd`: only Dynamic Client Registration, deprecated in 2026-07-28 in favour of CIMD
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 93 (weight 30)

- pass `tools.descriptions`: every tool has a description
- warn `tools.description_length`: 1 tools have descriptions over 1,024 characters, which crowds the context
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 9 of 9 tools declare readOnlyHint or destructiveHint
- pass `tools.directory_hints`: every tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
- pass `tools.token_cost`: about 2,782 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 75 (weight 15)

- warn `stability.changes`: 11 tool changes in 30 days
- pass `stability.rug_pull`: no tool changed its meaning under the same name

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 9, about 2,782 tokens to load them all
- tool set hash: 1c33c2ab27a9bd03fdf756acd1923467
- tools last changed: 2026-10-08T04:52:04.666Z
- badge: [![protogrid quality](https://protogrid.dev/badge/click.findyourrolefirst/jobfeed.svg)](https://protogrid.dev/servers/click.findyourrolefirst/jobfeed)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-10-08 `count_jobs` changed (inputSchema)
- 2026-10-08 `search_jobs` changed (inputSchema)
- 2026-10-07 `get_apply_kit` added
  - Everything needed to help the person apply to one role themselves: the apply link, the application form's questions when the careers site publishes them (every Greenhouse role does), what we know about the role (experience asked for, level, pay, place, dates) and a short checklist. Draft answers and tailor the résumé with the person; they submit. This service never submits applications. Uses a credit like get_job if not unlocked.
- 2026-10-07 `get_new_for_me` added
  - Roles matching this person's saved preferences that were found since `since` (ISO time), newest found first. Leave since empty for the last 24 hours. Save checked_at from the reply and pass it as since next time: a daily or hourly check then never repeats a role. Uses credits like search_jobs for roles not unlocked this month.
- 2026-10-07 `get_my_profile` added
  - What this person told Find your role first they want: name, where they live, the roles (whole fields like "Software engineering" or titles), places, remote-only, experience, and what their résumés suggested. Use it to search on their behalf. Free.
- 2026-10-02 `count_jobs` changed (inputSchema)
- 2026-10-02 `search_jobs` changed (inputSchema)
- 2026-10-02 `count_jobs` changed (inputSchema)
- 2026-10-02 `search_jobs` changed (inputSchema)
- 2026-10-01 `count_jobs` changed (inputSchema)

Full history: https://api.protogrid.dev/v1/servers/click.findyourrolefirst%2Fjobfeed/changes

## Remotes

- https://findyourrolefirst.click/mcp (streamable-http, auth oauth2, reachable true, uptime30d 0.9770115)

## Packages

_none_

## Tools (9)

- `count_jobs`: Count the roles a search_jobs call would match, up to 1,000. Free: no jobs returned, no credits used.

        Use it to narrow a search (add a location, exclude words, posted_within_hours) before paying for results.
        
- `get_apply_kit`: Everything needed to help the person apply to one role themselves: the apply link, the
        application form's questions when the careers site publishes them (every Greenhouse role
        does), what we know about the role (experience asked for, level, pay, place, dates) and a
        short checklist. Draft answers and tailor the résumé with the person; they submit.
        This service never submits applications. Uses a credit like get_job if not unlocked.
- `get_changes`: Get new, updated, reopened, and closed jobs. Save next_cursor for the next check.

        Excludes baseline imports. History lasts 90 days; expired cursors need a fresh search.
        
- `get_job`: Get a job's metadata, original posting and application URLs, and latest known status.

        No job description is returned. Search already includes these fields; use this to refresh one record.
        Check closed_at and last_checked before applying. Reading the source page needs a separate web tool.
        
- `get_my_profile`: What this person told Find your role first they want: name, where they live, the roles
        (whole fields like "Software engineering" or titles), places, remote-only, experience, and
        what their résumés suggested. Use it to search on their behalf. Free.
- `get_new_for_me`: Roles matching this person's saved preferences that were found since `since` (ISO time),
        newest found first. Leave since empty for the last 24 hours. Save checked_at from the
        reply and pass it as since next time: a daily or hourly check then never repeats a role.
        Uses credits like search_jobs for roles not unlocked this month.
- `get_usage`: Check your remaining monthly allowance. This tool doesn't use your data allowance.
- `list_my_jobs`: List roles this account already unlocked, newest first. Free, and doesn't use credits.
- `search_jobs`: Find open jobs checked within 24 hours. Up to 20 results, newest posted first.

        query matches whole words in the title or company (e.g. "product manager", "quant", "ml engineer").
        location takes a country ("United States", "UK", "India") or a city or state as written.
        exclude drops titles containing any of these words ("senior staff intern").
        remote=true keeps remote roles only. posted_within_hours keeps recent postings.
        Call count_jobs first (free) to size a search before spending credits.
        Use published_since for source dates and discovered_since for new discoveries excluding baselines.
        Follow next_offset to paginate. No JD text is returned.
        experience keeps roles whose posting asks for these years of experience: any of
        "0-1", "1-3", "3-5", "5-8", "8+", "not_stated" (read, names none), "unchecked" (not read, or no text).
        Read from each posting; include not_stated and unchecked unless you mean to drop those roles.
        family="product_adjacent" finds product, product marketing, growth, customer success,
        forward deployed and business operations titles in one search; query narrows within it.
        roles takes several titles at once (["Product Manager", "Software Engineer"]) and matches any;
        locations likewise (["United States", "London", "Remote"]).
        
