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
get_limits
How many jobs and saves are left today, and whether your plan includes resume generation.
- 2
get_candidate_profile
Titles, skills, location and authorization the agent should match against.
- 3
search_jobs
Use the curated feed for the best jobs to apply to; first_to_apply for the newest.
- 4
get_job
Full description for the job the agent picked.
- 5
get_master_resume
Your master resume text.
- 6
Your agent writes the resume
In whatever model and style you chose. GiraffyReach is not involved in this step.
- 7
save_tailored_resume
Uploads the PDF or DOCX against that job. It appears in your tracker.
- 8
get_applications
Returns the download link and the job URL.
- 9
Apply on the job URL
You or your agent complete the application on the company career page.
- 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
get_limits → get_candidate_profile → search_jobs → get_job
Same discovery steps as above.
- 2
prepare_application
GiraffyReach generates a resume tailored to that exact job from your master profile. Asynchronous; uses 1 resume credit.
- 3
get_applications
Poll until the resume is ready; returns the download link and the job URL.
- 4
Apply on the job URL, then mark_applied
Same finish as above.
Tools
The 14 tools available to every connected agent.
| Tool | What it does | Type |
|---|---|---|
| get_limits | Remaining capacity today: jobs, saves, resume credits, preparations, and which capabilities your plan includes. | Read-only |
| get_candidate_profile | Your profile as matching context: titles, skills, location, work authorization, sponsorship, relocation. | Read-only |
| search_jobs | Search the First-to-Apply (last 24h) and Curated (best to apply) feeds, with already-applied flags. | Read-only |
| get_job | Full detail for one job, including the posting description and the job URL. | Read-only |
| get_market_intelligence | Demand, salary bands and sponsorship climate from the last 24h of feeds — overall, or for one skill or company. | Read-only |
| get_master_resume | Your master resume text, so your own agent can write a tailored version. | Read-only |
| save_tailored_resume | Saves 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_application | Asks GiraffyReach to generate a resume tailored to one job (every plan: 25/60/100 a day). Uses 1 resume credit. | Write |
| get_applications | Status of saved and prepared applications, with 24-hour resume download links and career-page URLs. | Read-only |
| mark_applied | Records a job as applied in your tracker after the application was actually submitted. | Write |
| get_resume_settings | Your resume-tailoring settings: theme, tone, summary style, skills mode, format. | Read-only |
| update_resume_settings | Changes resume settings from chat. Applies to every future generation. | Write |
| get_outreach_intel | Which of your outreach resumes were opened and which got replies. | Read-only |
| get_hiring_contacts | Hiring 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.
| Tool | What it does |
|---|---|
| get_form_recipe | Step-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_fields | The agent pastes the labels it sees on an unfamiliar form and gets back what each field is and what to enter. |
| get_application_answers | Every 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_progress | Audit of what the agent filled, blockers (CAPTCHA, missing data) and questions that need you. Shows in your tracker. |
| get_verification_code | Reads 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.