Skip to content
Home/Resources/MCP Server
Developer Guide

ShouldApply in Claude and ChatGPT

The ShouldApply MCP server gives your AI assistant three job search tools: a ghost job check, an H-1B sponsor lookup and a salary estimate. One address, no account, no sign-in.

By Jesse Johnson, Founder of ShouldApply · Updated

Server Address

Paste this into your assistant
https://shouldapply.com/mcp
Transport
Streamable HTTP
Sign-in
None
Tools
3, all read-only

How to Connect

Claude
  1. 1.Open Settings, then Connectors.
  2. 2.Choose Add custom connector.
  3. 3.Paste the server address and save. There is no sign-in step.
ChatGPT
  1. 1.Open Settings, then Apps and connectors.
  2. 2.Turn on developer mode if it is off.
  3. 3.Add a new connector, paste the server address and pick no authentication.
Any other MCP client
  1. 1.Add a remote server over Streamable HTTP.
  2. 2.Use the server address as the URL.
  3. 3.Leave authentication empty.

Menu names move around between app versions. If yours looks different, search your assistant's settings for “connector” or “MCP”.

The Three Tools

Ghost job checkcheck_ghost_job

Tells you whether a posting looks real and still open. Send the job link and it reads the page for posting age and applicant count, checks whether the listing is closed and looks for the role on the employer's own careers page. Title, company and description text work too, with or without a link.

What comes back
Verdict: ACTIVE, STALE, GHOST or UNKNOWN
Risk level, as a bucket and not an exact percent
One plain reason
Confidence, and whether the page could be read
Try asking

Is this job still open? https://boards.greenhouse.io/acme/jobs/1234567

H-1B sponsor lookuplookup_h1b_sponsor

Returns an employer's H-1B filing record from Department of Labor data. Up to five employers whose names match, largest first, each with a link to its full record.

What comes back
Number of filings and approval rate
Average sponsored salary
Most common sponsored job titles
Green card certifications, when on record
Try asking

Does Stripe sponsor H-1B visas?

Salary estimateestimate_salary

Gives a US base salary range for a job title. Add a city, mark it remote or give a rough company size to adjust it. When there are enough real postings with listed pay, the range is the 25th to 75th percentile and you get the sample size.

What comes back
Low and high end, US dollars per year
Percentiles and sample size, when from postings
Source: postings or model
Confidence level
Try asking

What does a senior product designer make in Austin, TX?

Limits and What Gets Logged

The server is free, so it has guardrails. Each tool has a per-caller limit over ten minutes and a daily ceiling. When you hit one, the tool returns a short message and a link to the same check on the site. It never returns a made-up answer to fill the gap.

Good to know
Job links must be public http or https addresses. Private and internal addresses are refused.
Job description text is capped at 20,000 characters per call.
Ghost risk comes back as a bucket (low, medium, high, very high), not an exact percent.
Each call logs the tool, the assistant, the outcome and a short summary such as a company name. Connections are logged too. Description text is not stored in that record.
No tool writes, saves or changes anything. All three are read-only.

Full details are in the privacy policy. Questions or a bug to report: mail@shouldapply.com.

Go Deeper

Frequently Asked Questions

Do I need a ShouldApply account?

No. All three tools work without signing in, and nothing is tied to an account.

Does it cost anything?

No. The server is free. There are request limits so one caller can't use it all up, and each tool has a daily ceiling. If you hit one, the tool says so and points you to the same check on the site.

Can it score a job against my resume?

Not through the connector. The 0 to 100 fit score needs your skill profile, which lives in your ShouldApply account. These three tools only use public data: the posting itself, government filing records and pay listed on job postings.

Where does the data come from?

The ghost job check reads the posting you link to, looks for the role on the employer's careers page and weighs signals like posting age and missing pay. H-1B records come from U.S. Department of Labor LCA disclosure data. Salary ranges come from job postings with listed pay when there are enough of them for the role, and from a model based on title, location and company size when there aren't. Every result says which one you got.

What happens when there is no data?

The tool says so. An unknown company returns no matches with a note that it may file under another legal name. A job title with no pay data returns found: false and no numbers. A posting that blocks the page read comes back marked as a tentative verdict.

What does ShouldApply log?

One line per tool call: which tool, which assistant, whether it worked, how long it took and a short summary (the website a job link points to, the company name or the job title). A connection is logged too, with the assistant's name and version. Job description text isn't stored in that record. Your network address is used for rate limiting and isn't kept in the usage record.

Want the fit score too?

The connector covers public data. Scoring a job against your own skills happens in your ShouldApply account.

Get Your Free Score