Skip to content

analyze_job

Analyze a job posting against the user's profile.

Overview

Property Value
Cost $0.02 (2 cents)
Scope job_analysis

Arguments

Argument Type Required Description
job_url string One of these URL of the job posting
job_description string One of these Raw job posting text

Provide URL or description

You must provide either job_url or job_description, not both.

Response

{
  "job_id": 12345,
  "match_score": 85,
  "verdict": "APPLY",
  "matching_skills": [
    "Python",
    "PostgreSQL",
    "Docker"
  ],
  "missing_skills": [
    "Kubernetes",
    "Terraform"
  ],
  "red_flags": [
    "Mentions 'rockstar developer'",
    "Vague salary range"
  ],
  "honest_assessment": "Strong match for your backend experience. The Kubernetes requirement is listed as 'nice to have', so your Docker skills should suffice. The company has good Glassdoor reviews.",
  "suggested_cv_focus": [
    "Highlight your Python microservices experience",
    "Mention your PostgreSQL optimization work",
    "Include the AWS migration project"
  ]
}

Fields

Field Type Description
job_id integer ID for future reference (e.g., CV generation)
match_score integer 0-100 percentage match
verdict string APPLY, MAYBE, or SKIP
matching_skills array Skills you have that match
missing_skills array Required skills you lack
red_flags array Potential concerns
honest_assessment string Candid analysis of fit
suggested_cv_focus array Tips for your application

Example

curl -X POST https://jobko.ai/api/mcp/tools/call \
  -H "Authorization: Bearer jk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "analyze_job",
    "arguments": {
      "job_url": "https://linkedin.com/jobs/view/123456"
    }
  }'
import requests

response = requests.post(
    "https://jobko.ai/api/mcp/tools/call",
    headers={"Authorization": "Bearer jk_YOUR_KEY"},
    json={
        "name": "analyze_job",
        "arguments": {"job_url": "https://linkedin.com/jobs/view/123456"}
    }
)
analysis = response.json()
print(f"Match: {analysis['match_score']}% - {analysis['verdict']}")
mcporter call jobko.analyze_job --job_url "https://linkedin.com/jobs/view/123456"

Using Job Description Text

If you have the job text directly:

curl -X POST https://jobko.ai/api/mcp/tools/call \
  -H "Authorization: Bearer jk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "analyze_job",
    "arguments": {
      "job_description": "We are looking for a Senior Python Developer..."
    }
  }'

Supported Job Sites

The job_url parameter works with:

  • LinkedIn
  • Indeed
  • Glassdoor
  • Monster
  • WeWorkRemotely
  • Most company career pages

Use Cases

  • Quick job-fit assessment
  • Batch analysis of job listings
  • Automated job filtering in workflows