Skip to content

get_saved_jobs

List jobs that have been analyzed or saved.

Overview

Property Value
Cost Free
Scope jobs_read

Arguments

Argument Type Required Default Description
status string No all Filter: all, analyzed, saved, applied
limit integer No 10 Number of jobs to return (1-50)

Response

{
  "jobs": [
    {
      "id": 12345,
      "title": "Senior Python Developer",
      "company": "TechCorp",
      "location": "Remote",
      "match_score": 85,
      "verdict": "APPLY",
      "status": "analyzed",
      "analyzed_at": "2024-03-10T14:30:00Z",
      "url": "https://linkedin.com/jobs/view/123456"
    },
    {
      "id": 12346,
      "title": "Backend Engineer",
      "company": "StartupXYZ",
      "location": "San Francisco, CA",
      "match_score": 72,
      "verdict": "MAYBE",
      "status": "saved",
      "analyzed_at": "2024-03-09T10:15:00Z",
      "url": "https://indeed.com/job/abc123"
    }
  ],
  "total": 15,
  "has_more": true
}

Fields

Field Type Description
jobs array List of job objects
total integer Total matching jobs
has_more boolean Whether more results exist

Job Object

Field Type Description
id integer Job ID (use for generate_cv)
title string Job title
company string Company name
location string Job location
match_score integer 0-100 match percentage
verdict string APPLY, MAYBE, or SKIP
status string analyzed, saved, or applied
analyzed_at string When job was analyzed
url string Original job posting URL

Example

curl -X POST https://jobko.ai/api/mcp/tools/call \
  -H "Authorization: Bearer jk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "get_saved_jobs",
    "arguments": {
      "status": "analyzed",
      "limit": 10
    }
  }'

import requests

response = requests.post(
    "https://jobko.ai/api/mcp/tools/call",
    headers={"Authorization": "Bearer jk_YOUR_KEY"},
    json={
        "name": "get_saved_jobs",
        "arguments": {"status": "analyzed", "limit": 10}
    }
)
jobs = response.json()
for job in jobs["jobs"]:
    print(f"{job['title']} at {job['company']} - {job['match_score']}%")

mcporter call jobko.get_saved_jobs --status "analyzed" --limit 10

Status Filters

Status Description
all All jobs (default)
analyzed Jobs that have been analyzed
saved Jobs marked as saved/bookmarked
applied Jobs marked as applied

Use Cases

  • Show recent job analyses to user
  • Find job IDs for CV generation
  • Track application progress