FoundRole — AI Job Search & Application Tracker MCP for Claude & ChatGPT

Get job details

jobs_details

Fetches full details for one job by the id returned from jobs_search — the deeper view behind a search result.

Input:

job_id: The exact ID string from the id field of a jobs_search result.
result_item_id: The matching occurrence ID from that result's resultItemId field, when available.

Output: Complete job details: description, skills, benefits, requirements, salary benchmark, resume match, H-1B and E-Verify signals, job-trust analysis, and application link. A posting that passed the fully-remote check carries remoteCheck: the posting lines that make the role remote and where the employee may work from, or an unknown scope when the posting does not say. Personalized and extended insight fields follow the authenticated user's current entitlements.

Input Schema

Name	Required	Description	Default
`job_id`	Yes	The unique identifier of the job from jobs_search results
`result_item_id`	No	The result occurrence ID returned with the selected job

Output Schema

Name	Required	Description	Default
`job`	No
`studioUrl`	No
`trackedJob`	No
`statusOrder`	No
`trackerWebUrl`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedOct 9, 2026

addedOutput schema / properties / job / properties / insights / properties / employerFilingHistory

Added value: +{
+  "properties": {
+    "attribution": {
+      "enum": [
+        "FILED_BY"
+      ],
+      "type": "string"
+    },
+    "availability": {
+      "enum": [
+        "AVAILABLE",
+        "NO_FILINGS",
+        "UNRESOLVED_EMPLOYER",
+        "NOT_READY"
+      ],
+      "type": "string"
+    },
+    "bindingStatus": {
+      "enum": [
+        "LEGACY_UNREVIEWED",
+        "UNRESOLVED"
+      ],
+      "type": "string"
+    },
+    "coverage": {
+      "items": {
+        "properties": {
+          "fiscalYear": {
+            "type": "integer"
+          },
+          "id": {
+            "type": "string"
+          },
+          "quarter": {
+            "type": "integer"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "current": {
+      "properties": {
+        "filings": {
+          "type": "integer"
+        },
+        "id": {
+          "type": "string"
+        },
+        "workerPositions": {
+          "type": "integer"
+        }
+      },
+      "type": [
+        "object",
+        "null"
+      ]
+    },
+    "currentPeriod": {
+      "properties": {
+        "complete": {
+          "type": "boolean"
+        },
+        "coveredQuarters": {
+          "items": {
+            "properties": {
+              "fiscalYear": {
+                "type": "integer"
+              },
+              "id": {
+                "type": "string"
+              },
+              "quarter": {
+                "type": "integer"
+              }
+            },
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "endFiscalYear": {
+          "type": "integer"
+        },
+        "endQuarter": {
+          "type": "integer"
+        },
+        "id": {
+          "type": "string"
+        },
+        "label": {
+          "type": "string"
+        },
+        "startFiscalYear": {
+          "type": "integer"
+        },
+        "startQuarter": {
+          "type": "integer"
+        }
+      },
+      "type": [
+        "object",
+        "null"
+      ]
+    },
+    "history": {
+      "properties": {
+        "access": {
+          "enum": [
+            "AVAILABLE",
+            "RESTRICTED",
+            "UNAVAILABLE"
+          ],
+          "type": "string"
+        },
+        "id": {
+          "type": "string"
+        },
+        "points": {
+          "items": {
+            "properties": {
+              "filings": {
+                "type": "integer"
+              },
+              "id": {
+                "type": "string"
+              },
+              "period": {
+                "properties": {
+                  "complete": {
+                    "type": "boolean"
+                  },
+                  "coveredQuarters": {
+                    "items": {
+                      "properties": {
+                        "fiscalYear": {
+                          "type": "integer"
+                        },
+                        "id": {
+                          "type": "string"
+                        },
+                        "quarter": {
+                          "type": "integer"
+                        }
+                      },
+                      "type": "object"
+                    },
+                    "type": "array"
+                  },
+                  "endFiscalYear": {
+                    "type": "integer"
+                  },
+                  "endQuarter": {
+                    "type": "integer"
+                  },
+                  "id": {
+                    "type": "string"
+                  },
+                  "label": {
+                    "type": "string"
+                  },
+                  "startFiscalYear": {
+                    "type": "integer"
+                  },
+                  "startQuarter": {
+                    "type": "integer"
+                  }
+                },
+                "type": [
+                  "object",
+                  "null"
+                ]
+              },
+              "workerPositions": {
+                "type": "integer"
+              }
+            },
+            "type": "object"
+          },
+          "type": [
+            "array",
+            "null"
+          ]
+        }
+      },
+      "type": "object"
+    },
+    "id": {
+      "type": "string"
+    },
+    "subject": {
+      "properties": {
+        "domain": {
+          "type": "string"
+        },
+        "domainDictionaryId": {
+          "type": "string"
+        },
+        "id": {
+          "type": "string"
+        },
+        "name": {
+          "type": "string"
+        }
+      },
+      "type": [
+        "object",
+        "null"
+      ]
+    },
+    "wageLevel": {
+      "properties": {
+        "availability": {
+          "enum": [
+            "AVAILABLE",
+            "NO_FILINGS",
+            "INSUFFICIENT_SAMPLE",
+            "NOT_STATED",
+            "NOT_READY",
+            "UNRESOLVED_EMPLOYER"
+          ],
+          "type": "string"
+        },
+        "breakdown": {
+          "properties": {
+            "level1Pct": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "level2Pct": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "level3Pct": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "level4Pct": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "notStatedPct": {
+              "type": [
+                "number",
+                "null"
+              ]
+            }
+          },
+          "type": [
+            "object",
+            "null"
+          ]
+        },
+        "id": {
+          "type": "string"
+        },
+        "period": {
+          "properties": {
+            "complete": {
+              "type": "boolean"
+            },
+            "coveredQuarters": {
+              "items": {
+                "properties": {
+                  "fiscalYear": {
+                    "type": "integer"
+                  },
+                  "id": {
+                    "type": "string"
+                  },
+                  "quarter": {
+                    "type": "integer"
+                  }
+                },
+                "type": "object"
+              },
+              "type": "array"
+            },
+            "endFiscalYear": {
+              "type": "integer"
+            },
+            "endQuarter": {
+              "type": "integer"
+            },
+            "id": {
+              "type": "string"
+            },
+            "label": {
+              "type": "string"
+            },
+            "startFiscalYear": {
+              "type": "integer"
+            },
+            "startQuarter": {
+              "type": "integer"
+            }
+          },
+          "type": [
+            "object",
+            "null"
+          ]
+        },
+        "sampleSize": {
+          "type": "integer"
+        }
+      },
+      "type": "object"
+    }
+  },
+  "type": [
+    "object",
+    "null"
+  ]
+}

Changed7 schema fields changedOct 8, 2026

addedInput schema / properties / job_id / minLength
```
Added value: +1
```

addedInput schema / properties / result_item_id

Added value: +{
+  "description": "The result occurrence ID returned with the selected job",
+  "type": "string"
+}

removedOutput schema / properties / job / properties / companyRating

Removed value: -{
-  "type": [
-    "number",
-    "null"
-  ]
-}

removedOutput schema / properties / job / properties / estimatedSalary / properties / basedOn
```
Removed value: -{
-  "type": [
-    "string",
-    "null"
-  ]
-}
```

addedOutput schema / properties / job / properties / remoteCheck

Added value: +{
+  "properties": {
+    "quotes": {
+      "items": {
+        "properties": {
+          "source": {
+            "type": "string"
+          },
+          "text": {
+            "type": [
+              "string",
+              "null"
+            ]
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "workFrom": {
+      "properties": {
+        "allowedPlaces": {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "excludedPlaces": {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "quotes": {
+          "items": {
+            "properties": {
+              "source": {
+                "type": "string"
+              },
+              "text": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              }
+            },
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "scope": {
+          "type": "string"
+        }
+      },
+      "type": "object"
+    }
+  },
+  "type": [
+    "object",
+    "null"
+  ]
+}

addedOutput schema / properties / job / properties / resultItemId

Added value: +{
+  "type": [
+    "string",
+    "null"
+  ]
+}

addedOutput schema / properties / studioUrl

Added value: +{
+  "type": [
+    "string",
+    "null"
+  ]
+}

Changed1 schema field changedAug 11, 2026
- addedOutput schema / properties / job / properties / estimatedSalary / properties / currency
```
Added value: +{
+  "type": [
+    "string",
+    "null"
+  ]
+}
```
Changed4 schema fields changedAug 4, 2026
- addedOutput schema / properties / job / properties / insights / properties / match / properties / breakdown / properties / alignmentKind
```
Added value: +{
+  "type": [
+    "string",
+    "null"
+  ]
+}
```
- addedOutput schema / properties / job / properties / insights / properties / match / properties / breakdown / properties / alignmentMultiplier
```
Added value: +{
+  "type": [
+    "number",
+    "null"
+  ]
+}
```
- addedOutput schema / properties / job / properties / insights / properties / match / properties / breakdown / properties / jobCareerProfileId
```
Added value: +{
+  "type": [
+    "integer",
+    "null"
+  ]
+}
```
- addedOutput schema / properties / job / properties / insights / properties / match / properties / breakdown / properties / jobCareerSpecializationId
```
Added value: +{
+  "type": [
+    "integer",
+    "null"
+  ]
+}
```

Changed3 schema fields changedAug 4, 2026

addedOutput schema / properties / job / properties / insights / properties / match / properties / grade
```
Added value: +{
+  "type": [
+    "string",
+    "null"
+  ]
+}
```
addedOutput schema / properties / job / properties / insights / properties / match / properties / gradeConfidence
```
Added value: +{
+  "type": [
+    "string",
+    "null"
+  ]
+}
```

addedOutput schema / properties / job / properties / insights / properties / match / properties / gradeReasons

Added value: +{
+  "items": {
+    "properties": {
+      "code": {
+        "type": "string"
+      },
+      "params": {
+        "type": [
+          "object",
+          "null"
+        ]
+      },
+      "severity": {
+        "type": "string"
+      }
+    },
+    "type": "object"
+  },
+  "type": "array"
+}

Changed3 schema fields changedJul 20, 2026

addedInput schema / $schema

Added value: +"https://json-schema.org/draft/2020-12/schema"

addedInput schema / additionalProperties
```
Added value: +false
```

addedOutput schema / $schema

Added value: +"https://json-schema.org/draft/2020-12/schema"

Changed5 schema fields changedJul 11, 2026

addedOutput schema / properties / job / properties / estimatedSalary / properties / max
```
Added value: +{
+  "type": [
+    "number",
+    "null"
+  ]
+}
```
addedOutput schema / properties / job / properties / estimatedSalary / properties / min
```
Added value: +{
+  "type": [
+    "number",
+    "null"
+  ]
+}
```
addedOutput schema / properties / job / properties / estimatedSalary / properties / updatedAt
```
Added value: +{
+  "type": [
+    "string",
+    "null"
+  ]
+}
```

addedOutput schema / properties / job / properties / insights

Added value: +{
+  "properties": {
+    "eVerify": {
+      "type": [
+        "boolean",
+        "null"
+      ]
+    },
+    "ghostScore": {
+      "properties": {
+        "confidence": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "grade": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "reasons": {
+          "items": {
+            "properties": {
+              "code": {
+                "type": "string"
+              },
+              "params": {
+                "type": [
+                  "object",
+                  "null"
+                ]
+              },
+              "severity": {
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          "type": "array"
+        }
+      },
+      "type": [
+        "object",
+        "null"
+      ]
+    },
+    "h1bHistory": {
+      "items": {
+        "properties": {
+          "fiscalPeriod": {
+            "type": "string"
+          },
+          "petitions": {
+            "type": "integer"
+          },
+          "workers": {
+            "type": "integer"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "h1bPetitions": {
+      "properties": {
+        "count": {
+          "type": [
+            "integer",
+            "null"
+          ]
+        },
+        "fiscalPeriod": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "workers": {
+          "type": [
+            "integer",
+            "null"
+          ]
+        }
+      },
+      "type": [
+        "object",
+        "null"
+      ]
+    },
+    "h1bSponsor": {
+      "type": [
+        "boolean",
+        "null"
+      ]
+    },
+    "match": {
+      "properties": {
+        "breakdown": {
+          "properties": {
+            "jobRank": {
+              "type": [
+                "integer",
+                "null"
+              ]
+            },
+            "jobTrack": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "scoredSkillCount": {
+              "type": [
+                "integer",
+                "null"
+              ]
+            },
+            "seniorityMultiplier": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "skillScore": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "userRank": {
+              "type": [
+                "integer",
+                "null"
+              ]
+            },
+            "userTrack": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "weightedDenominator": {
+              "type": [
+                "number",
+                "null"
+              ]
+            }
+          },
+          "type": [
+            "object",
+            "null"
+          ]
+        },
+        "insufficientData": {
+          "type": "boolean"
+        },
+        "matchedCount": {
+          "type": "integer"
+        },
+        "matchedRequiredCount": {
+          "type": "integer"
+        },
+        "missingNice": {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "missingNiceTotal": {
+          "type": "integer"
+        },
+        "missingRequired": {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "missingRequiredTotal": {
+          "type": "integer"
+        },
+        "requiredTotal": {
+          "type": "integer"
+        },
+        "score": {
+          "type": [
+            "integer",
+            "null"
+          ]
+        },
+        "seniorityMatch": {
+          "type": [
+            "string",
+            "null"
+          ]
+        }
+      },
+      "type": [
+        "object",
+        "null"
+      ]
+    }
+  },
+  "type": [
+    "object",
+    "null"
+  ]
+}

addedOutput schema / properties / job / properties / salaryBand

Added value: +{
+  "properties": {
+    "max": {
+      "type": "number"
+    },
+    "min": {
+      "type": "number"
+    }
+  },
+  "type": [
+    "object",
+    "null"
+  ]
+}

Changed1 schema field changedJun 13, 2026
- addedOutput schema / properties / trackerWebUrl
```
Added value: +{
+  "type": "string"
+}
```

Changed2 schema fields changedJun 10, 2026

addedOutput schema / properties / statusOrder

Added value: +{
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

addedOutput schema / properties / trackedJob

Added value: +{
+  "type": [
+    "object",
+    "null"
+  ]
+}

Changed1 schema field changedJun 9, 2026

changedInput schema / properties / job_id / description

Previous value: -"The unique identifier of the job from jobs.search results"New value: +"The unique identifier of the job from jobs_search results"

Changed1 schema field changedJun 5, 2026

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "properties": {
+    "job": {
+      "properties": {
+        "benefits": {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "bonuses": {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "category": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "companyName": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "companyRating": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "companySize": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "companyWebsite": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "description": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "employmentType": {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "estimatedSalary": {
+          "properties": {
+            "basedOn": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "median": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "p25": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "p75": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "sampleSize": {
+              "type": [
+                "integer",
+                "null"
+              ]
+            }
+          },
+          "type": [
+            "object",
+            "null"
+          ]
+        },
+        "id": {
+          "type": "string"
+        },
+        "link": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "location": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "logoUrl": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "postedAt": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "requirements": {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "salary": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "skills": {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "subcategory": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "title": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "url": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "workLocationType": {
+          "type": [
+            "string",
+            "null"
+          ]
+        }
+      },
+      "required": [
+        "id"
+      ],
+      "type": "object"
+    }
+  },
+  "type": "object"
+}

First observedJun 3, 2026

TDQS

A4.4/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The description goes well beyond the annotations by enumerating what the payload contains (description, skills, benefits, salary benchmark, resume match, H-1B/E-Verify signals, trust analysis, application link), explaining the conditional `remoteCheck` field, and noting that personalized/extended fields depend on the caller's entitlements. There is mild tension with the structured hints (readOnlyHint=false and idempotentHint=false on what is described as a fetch), but the description itself discloses no destructive or mutating behavior and the hints appear to be conservative defaults rather than a substantive conflict.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded with the core purpose, then cleanly separated into Input and Output blocks, with zero filler sentences. The Output block is somewhat long given that an output schema already exists, so it is more verbose than strictly necessary, but each listed item carries semantic meaning.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Covers everything an agent needs: where each identifier comes from, what the single required parameter must be, what the response contains, the conditional `remoteCheck` semantics, and the entitlement-dependent nature of personalized fields. With an output schema present, this is more than sufficient.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3, but the description adds provenance meaning the schema lacks: `job_id` must be 'the exact ID string from the `id` field of a jobs_search result' and `result_item_id` is the matching `resultItemId` 'when available', clarifying that one of the two identifiers is conditional.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource ('Fetches full details for one job') and immediately positions it against the sibling that produces the input ('the deeper view behind a search result', keyed by the id from jobs_search). An agent can distinguish it from jobs_search, jobs_compare, and jobs_recommendations without opening any schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives clear retrieval context: call it with the `id` from a jobs_search result, optionally paired with that result's `resultItemId`. It does not explicitly state when not to use it (e.g., to discover jobs in the first place, use jobs_search), but the sequencing dependency is unambiguous enough for correct routing.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All FoundRole — AI Job Search & Application Tracker MCP for Claude & ChatGPT tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.