Agent Connect · MCP

Connect your AI agent to GiraffyReach.

ChatGPT, Claude, or any MCP-compatible agent can search your First-to-Apply and Curated feeds, save resumes against jobs, and track your applications — all scoped to your own account.

What it is

Agent Connect exposes your GiraffyReach account to your own AI agent over MCP (Model Context Protocol). You tell your agent things like "find fresh jobs that match me and prep the top five" — it reads your profile, searches the feeds, checks your limits, writes or requests a tailored resume, saves it against the job, and records the application once it is submitted. Everything is scoped to your own account and revocable at any time.

How to connect

ChatGPT or Claude

The GiraffyReach connector will be available in the ChatGPT and Claude app directories. Until then, add it as a custom connector with the URL below and sign in with your GiraffyReach account when prompted.

https://app.giraffyreach.com/api/mcp
  • ChatGPT (Plus / Pro / Business): Settings → Connectors → Create
  • Claude (paid plans, web and desktop): Settings → Connectors → Add custom connector

Developer mode

Generate a header token at Agent Connect and install it in your coding agent. See the Developer mode section below.

Flow: bring your own AI

Your agent writes the resume; GiraffyReach saves and tracks it. Available on every plan.

  1. 1

    get_limits

    How many jobs and saves are left today, and whether your plan includes resume generation.

  2. 2

    get_candidate_profile

    Titles, skills, location and authorization the agent should match against.

  3. 3

    search_jobs

    Use the curated feed for the best jobs to apply to; first_to_apply for the newest.

  4. 4

    get_job

    Full description for the job the agent picked.

  5. 5

    get_master_resume

    Your master resume text.

  6. 6

    Your agent writes the resume

    In whatever model and style you chose. GiraffyReach is not involved in this step.

  7. 7

    save_tailored_resume

    Uploads the PDF or DOCX against that job. It appears in your tracker.

  8. 8

    get_applications

    Returns the download link and the job URL.

  9. 9

    Apply on the job URL

    You or your agent complete the application on the company career page.

  10. 10

    mark_applied

    Records the application in your tracker once it was submitted.

Flow: GiraffyReach generates the resume

Included with every plan (25 a day on Feed, 60 on Advantage, 100 on Dominance). get_limits reports capabilities.generate_resume.

  1. 1

    get_limits → get_candidate_profile → search_jobs → get_job

    Same discovery steps as above.

  2. 2

    prepare_application

    GiraffyReach generates a resume tailored to that exact job from your master profile. Asynchronous; uses 1 resume credit.

  3. 3

    get_applications

    Poll until the resume is ready; returns the download link and the job URL.

  4. 4

    Apply on the job URL, then mark_applied

    Same finish as above.

Tools

The 14 tools available to every connected agent.

ToolWhat it doesType
get_limitsRemaining capacity today: jobs, saves, resume credits, preparations, and which capabilities your plan includes.Read-only
get_candidate_profileYour profile as matching context: titles, skills, location, work authorization, sponsorship, relocation.Read-only
search_jobsSearch the First-to-Apply (last 24h) and Curated (best to apply) feeds, with already-applied flags.Read-only
get_jobFull detail for one job, including the posting description and the job URL.Read-only
get_market_intelligenceDemand, salary bands and sponsorship climate from the last 24h of feeds — overall, or for one skill or company.Read-only
get_master_resumeYour master resume text, so your own agent can write a tailored version.Read-only
save_tailored_resumeSaves a resume your agent wrote (PDF or DOCX, up to 4 MB) against a job, so it shows in your tracker with a download link.Write
prepare_applicationAsks GiraffyReach to generate a resume tailored to one job (every plan: 25/60/100 a day). Uses 1 resume credit.Write
get_applicationsStatus of saved and prepared applications, with 24-hour resume download links and career-page URLs.Read-only
mark_appliedRecords a job as applied in your tracker after the application was actually submitted.Write
get_resume_settingsYour resume-tailoring settings: theme, tone, summary style, skills mode, format.Read-only
update_resume_settingsChanges resume settings from chat. Applies to every future generation.Write
get_outreach_intelWhich of your outreach resumes were opened and which got replies.Read-only
get_hiring_contactsHiring managers and referral candidates for a job's company. Capped at 25 lookups per day.Read-only

Developer mode

A header token for coding agents that drive the browser and apply end to end. It unlocks five extra tools on top of the 14 above. Verified clients: Claude Code, Claude Desktop, Codex CLI, Cursor, Windsurf.

ToolWhat it does
get_form_recipeStep-by-step playbook for a job URL's ATS: click sequence, account flow, custom widgets, fields to leave empty, where a CAPTCHA will stop it.
classify_form_fieldsThe agent pastes the labels it sees on an unfamiliar form and gets back what each field is and what to enter.
get_application_answersEvery answer for a job's application form in one call, plus the tailored resume link and whether you allowed the agent to submit.
report_application_progressAudit of what the agent filled, blockers (CAPTCHA, missing data) and questions that need you. Shows in your tracker.
get_verification_codeReads OTP codes or verification links from your connected Gmail when a career page emails one mid-application.

Claude Code · terminal

claude mcp add --transport http giraffyreach https://app.giraffyreach.com/api/mcp \
  --header "Authorization: Bearer <token>"

Claude Desktop · claude_desktop_config.json

{
  "mcpServers": {
    "giraffyreach": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://app.giraffyreach.com/api/mcp", "--header", "Authorization: Bearer <token>"]
    }
  }
}

Codex CLI · ~/.codex/config.toml (token in GIRAFFYREACH_TOKEN)

[mcp_servers.giraffyreach]
url = "https://app.giraffyreach.com/api/mcp"
bearer_token_env_var = "GIRAFFYREACH_TOKEN"

Cursor · .cursor/mcp.json

{
  "mcpServers": {
    "giraffyreach": {
      "url": "https://app.giraffyreach.com/api/mcp",
      "headers": { "Authorization": "Bearer <token>" }
    }
  }
}

Windsurf · ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "giraffyreach": {
      "serverUrl": "https://app.giraffyreach.com/api/mcp",
      "headers": { "Authorization": "Bearer <token>" }
    }
  }
}

Replace <token> with the token from Agent Connect. It is shown once when generated.

Limits

  • Distinct jobs per day: 50 on Feed, 100 on Advantage, 200 on Dominance and during the trial. Re-reading a job already delivered today is free.
  • 50 resume saves per day with save_tailored_resume.
  • Files: PDF or DOCX, up to 4 MB.
  • Resume download links are valid for 24 hours; ask get_applications for a fresh one.
  • 50 preparations per day with prepare_application, inside your plan's resume-credit budget (shared with the web app and Autopilot).

Privacy

The connector reads your profile, your master resume text, job feed results, and your application status. It writes the resumes your agent saves, resume settings changes you ask for, and application status in your tracker. Nothing else. Your agent runs under your own AI subscription; GiraffyReach does not send your data to Anthropic or OpenAI on its own. Job descriptions are third-party content and are labelled so agents treat them as data, not instructions. You can revoke any connection at any time from Agent Connect.

FAQ

Which plans include Agent Connect?

Every GiraffyReach plan and the free trial. Every plan includes GiraffyReach resume generation through prepare_application (25 a day on Feed, 60 on Advantage, 100 on Dominance), and on every plan your agent can also write the resume itself from get_master_resume and save it with save_tailored_resume. get_limits tells your agent which capabilities your plan includes.

Can my agent actually submit applications for me?

With Developer mode, yes, if you allow it. In your profile's Job Application Details tab, tick "Let my AI agents submit applications for me." Until then get_application_answers returns submit_allowed=false and the agent fills everything, logs the completed form, and asks you to review and click Submit. Every field it fills is written to your tracker first (report_application_progress). Directory connectors in ChatGPT and Claude do not drive job sites; they prepare and save resumes and you finish on the career page.

What can the agent NOT do on a job site?

Solve CAPTCHAs (it stops and hands the page back to you), fill fields the site hides as bot traps (it is told which ones), or invent answers to essay questions — those come back to you as needs_user_input unless you gave an answer.

Why did a save or preparation fail?

The usual reasons: you already applied to that job, you hit the daily cap (jobs, saves or preparations), the file was over 4 MB or not a PDF/DOCX, your master profile or resume settings are not finalized, or your phone is not verified yet. Your agent sees the exact reason and can relay it.

How do I disconnect an agent?

On the Agent Connect page in your dashboard: revoke a single ChatGPT or Claude connection from the Connected agents list, or revoke the Developer-mode token. Access ends immediately.

What does "applied" mean in my tracker?

Applied is only marked when the application was actually submitted — same rules as the web app. Agent saves and preparations show as "Resume ready" until then.

Questions or feedback?

Write to info@giraffyreach.com.