getmattered-mcp 0.0.0-stage → 1.10.0

package/CHANGELOG.md

@@ -0,0 +1,73 @@
+# Changelog
+
+## 1.10.0
+
+AI Applyd is now GetMattered. This release renames the package and changes no tool behavior.
+
+- The npm package is `getmattered-mcp`. The old `aiapplyd-mcp` package stays on npm and points here.
+- The package installs two commands, `getmattered-mcp` and the old `aiapplyd-mcp`. Both run the same file.
+- The default endpoint is `https://mcp.getmattered.com/mcp`. To reach the old host during the
+  overlap, set `GETMATTERED_MCP_URL=https://mcp.aiapplyd.com/mcp`.
+- `GETMATTERED_TOKEN` and `GETMATTERED_MCP_URL` replace `AIAPPLYD_TOKEN` and `AIAPPLYD_MCP_URL`.
+  The old names are still read when the new ones are unset.
+- Tool ids are `getmattered_<name>`. `call` also accepts the old `aiapplyd_<name>` ids and runs
+  whichever name the server lists.
+- The stored sign-in moves to `~/.config/getmattered/credentials.json`. A sign-in in the old
+  `~/.config/aiapplyd/credentials.json` is still read, and `logout` removes both.
+- The plugin is `getmattered` in `plugins/getmattered`, and the tool map skill is `using-getmattered`.
+- The MCP Registry name is `com.getmattered/getmattered`. Homepage, repository, support and
+  maintainer addresses use getmattered.com and github.com/getmattered/getmattered-mcp.
+- Logos and images are unchanged.
+
+## 1.9.1
+
+Corrects application coverage in package and plugin descriptions to 30+ hiring systems. Updates the gallery image to match current application coverage. Includes fourteen portable job-search skills.
+
+## 1.9.0
+
+The assistant bundle has fourteen job-search skills. Four new skills cover the tool map, recruiter replies, follow-ups and saved searches.
+
+New tools on the hosted server:
+
+- `aiapplyd_get_inbox` reads the emails employers sent to the user's AI Applyd address, with drafted replies for a conversation. Sign-up codes and other account mail are marked and never count as an employer reply.
+- `aiapplyd_reply_to_email` sends the user's reply to an employer. Skills show the exact text first and send only after the user says yes to it.
+- `aiapplyd_update_auto_apply` turns Auto Apply on or off and sets review or auto mode, the daily limit and the lowest match. Turning it on or choosing auto mode needs the user's yes.
+- `aiapplyd_update_application_profile` reads and saves the answers employer forms need, and lists the details recent applications had to guess.
+- `aiapplyd_manage_follow_ups` lists due follow-ups, drafts one, sends it from a connected Gmail or Outlook after the user's yes, or records one the user sent.
+- `aiapplyd_manage_saved_searches` saves the current job preferences as a named search and turns email alerts for new matches on or off.
+
+Changed behavior:
+
+- `aiapplyd_score_resume`, `aiapplyd_optimize_resume` and `aiapplyd_translate_resume` take `resume_text` for a resume pasted in the chat, or `resume_file` for a file attached in ChatGPT. `aiapplyd_generate_cover_letter` takes `resume_text`. Without them, the tools use the resume on file.
+- Translation and cover letters no longer need a resume-builder document.
+- `aiapplyd_set_resume` also takes `resume_file`.
+- `aiapplyd_build_pdf` with no `resume_text` returns the PDF link of the resume on file and creates nothing.
+
+Skills:
+
+- `using-ai-applyd` maps each request to its tools and order, lists the actions that need the user's yes, and ends each result with one next step offered to the user, with no prices or billing links.
+- `handle-recruiter-replies`, `follow-up-on-applications` and `manage-saved-searches` are new.
+- The apply, setup, tailoring, cover letter, translation, resume document, matching, tracking and interview skills describe the new resume sources and point to the new workflows. `apply-to-a-job` covers Auto Apply settings.
+
+The package, registry/npm manifest, client manifests, root lockfile metadata and CLI version output use 1.9.0. The prepublish check expects fourteen skills. Dependency versions are unchanged.
+
+## 1.8.5
+
+Publishes the ten-skill bundle from 1.8.4 to npm and the MCP Registry. npm still held an older 1.8.4 build staged on October 8, so this release uses the next version number. The code and skills match 1.8.4.
+
+## 1.8.4
+
+The assistant bundle has ten job-search skills. Five new workflows cover account setup, cover letters, interview practice, resume translation and editable resume-builder drafts.
+
+- OpenAI and Codex listing metadata now includes all supported job-search workflows, a valid subtitle, a support URL and example prompts. Review annotations match all 17 live tools.
+- The cover-letter skill selects the correct saved builder document for a new letter and uses revision instructions only for an existing application.
+- The resume-tailoring skill runs the analysis, score or rewrite the user requested. It does not start a chain of other credit-consuming tasks.
+- A prepublish check refuses missing skills, icons or manifests, mismatched versions and invalid OpenAI metadata.
+- npm now includes the plugin manifests, icons and all ten skill files alongside the CLI bridge.
+- Gemini CLI discovers the same canonical skill files as the Claude, Cursor and Codex plugin packages through the root `skills/` link.
+- OpenAI's setup action opens the packaged job-search setup skill after installation.
+- Skills check account limits and request approval before credit-consuming actions or application sends. An application counts as landed only with employer evidence.
+- Resume translation uses the default saved builder document, or the first saved build. It saves a separate translation.
+- The resume-builder tool creates an editable summary draft of up to 2,000 characters. A full resume needs structured sections or an imported file in the builder before PDF export.
+
+The package, registry/npm manifest, client manifests, root lockfile metadata and CLI version output use 1.8.4. Dependency versions are unchanged. Store publication remains subject to each platform's review.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 GetMattered
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,493 @@
-# Temporary Holding Version
+<div align="center">
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+<img src="assets/logo.png" alt="GetMattered" width="96" height="96" />
+
+# GetMattered MCP Server
+
+Version 1.10.0 renames the package from `aiapplyd-mcp` to `getmattered-mcp`. AI Applyd is now
+GetMattered. It includes fourteen portable job-search skills. See the [changelog](CHANGELOG.md).
+
+**Auto-Apply That Ends on an Interview**
+
+**Stop applying. Start interviewing.**
+
+Score your resume the way the screening software scores it, rewrite it for the exact role,
+write the cover letter, prepare for the interview, and send the application in on the
+employer's own hiring system. All from inside the assistant you already work in.
+
+<br />
+
+<img src="assets/01-stop-applying-start-interviewing.png" alt="GetMattered - stop applying, start interviewing" width="820" />
+
+**And it keeps the employer's own confirmation.** Most tools count applications sent, which is
+a number the tool awards itself off its own button click. This one reports what the employer's
+system actually returned, so a real rejection is distinguishable from a form that quietly
+dropped your application.
+
+[![Glama quality score](https://glama.ai/mcp/servers/aiapplyd/aiapplyd-mcp/badges/score.svg)](https://glama.ai/mcp/servers/aiapplyd/aiapplyd-mcp)
+[![Smithery](https://img.shields.io/badge/Smithery-aiapplyd%2Faiapplyd-7c3aed)](https://smithery.ai/servers/aiapplyd/aiapplyd)
+[![MCP Registry](https://img.shields.io/badge/MCP%20Registry-com.getmattered%2Fgetmattered-blue)](https://registry.modelcontextprotocol.io/v0/servers?search=getmattered)
+[![GetMattered on LobeHub](https://lobehub.com/badge/mcp/aiapplyd-aiapplyd-mcp)](https://lobehub.com/mcp/aiapplyd-aiapplyd-mcp)
+[![Listed on mcpservers.org](https://mcpservers.org/badge.svg)](https://mcpservers.org/servers/aiapplyd/aiapplyd-mcp)
+[![Listed on cursor.directory](https://img.shields.io/badge/Listed%20on-cursor.directory-black)](https://cursor.directory/plugins/ai-applyd-1)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+
+**[Listing page](https://getmattered.com/mcps)** · **[Website](https://getmattered.com)** · **[Privacy](https://getmattered.com/legal/privacy)** · **[Terms](https://getmattered.com/legal/terms)**
+
+</div>
+
+---
+
+Most applicants are screened out by software before a person reads a word, and a good number
+are never screened at all, because the form silently dropped a required field or the upload
+never attached. From the candidate's side those look identical to rejection, which is why so
+many people rewrite a CV nobody ever read.
+
+This server puts both halves of that process in your hands: the screening, and the proof that
+the application arrived.
+
+<div align="center">
+
+<img src="assets/02-only-roles-that-actually-fit.png" alt="Only roles that actually fit, scored before you see them" width="49%" />
+<img src="assets/03-the-company-confirmed-it.png" alt="The employer's own system confirming an application arrived" width="49%" />
+
+<img src="assets/04-sent-means-they-got-it.png" alt="Sent means they got it: every application carries the employer's confirmation" width="49%" />
+<img src="assets/05-we-apply-where-the-jobs-live.webp" alt="It applies on 30+ hiring systems, where the jobs actually live" width="49%" />
+
+<img src="assets/06-you-always-know-where-you-stand.png" alt="You always know where every application stands" width="49%" />
+<img src="assets/07-they-wrote-back-an-interview.png" alt="They wrote back: an interview, not a no" width="49%" />
+
+<img src="assets/08-wake-up-to-interviews.png" alt="Wake up to interviews" width="820" />
+
+<sub>From the first match to the interview invite. Every application carries the employer's own confirmation.</sub>
+
+</div>
+
+Every application goes in on the company's real careers page, under your name, with your own
+materials. It lands on 30+ hiring systems, including **Greenhouse, Lever, Ashby, Workday, Personio, Teamtailor, SmartRecruiters, Recruitee, Breezy, Workable, Rippling, BambooHR, JazzHR, softgarden, Jobvite, Gem, Zoho Recruit, Dayforce, Hireology, Dover, Oracle Recruiting Cloud, Paylocity, Oracle Taleo, UKG Pro Recruiting, ADP, Avature, CareerPlug, Pinpoint, Manatal, and Eightfold**.
+
+Nothing to install. Connect once and run it from Claude, ChatGPT, Codex, Cursor, Gemini CLI, VS Code or any MCP client, and from your phone over iMessage through Poke.
+
+**The whole job search in five calls:** see your matches (`getmattered_get_matches`), apply to one
+(`getmattered_apply`, sent automatically or held for your yes), approve or reject what is waiting
+(`getmattered_review_application`), track every application to the employer's own receipt
+(`getmattered_get_applications`), and check your plan and what is left (`getmattered_get_account`).
+The full list is under [Tools](#tools).
+
+## Watch the demo
+
+[![GetMattered demo: AI auto-apply to jobs that ends on an interview](https://img.youtube.com/vi/xt1pbpVzf4I/maxresdefault.jpg)](https://www.youtube.com/watch?v=xt1pbpVzf4I)
+
+90 seconds: resume upload, job matching, a real application sent on the employer's own form, the
+employer's confirmation email, interview prep, and applying from ChatGPT, Claude and Cursor.
+
+## Quick start
+
+One click, if your app supports it:
+
+[![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/install-mcp?name=getmattered&config=eyJ1cmwiOiJodHRwczovL21jcC5nZXRtYXR0ZXJlZC5jb20vbWNwIn0=)
+[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_Server-0098FF?logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=getmattered&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A//mcp.getmattered.com/mcp%22%7D)
+[![Add to Poke (iMessage)](https://img.shields.io/badge/iMessage-Add_to_Poke-34C759?logo=imessage&logoColor=white)](https://poke.com/integrations/new?name=GetMattered&url=https%3A%2F%2Fmcp.getmattered.com%2Fmcp)
+
+
+GetMattered is a **hosted remote MCP server**. Point your client at one URL:
+
+```
+https://mcp.getmattered.com/mcp
+```
+
+The first tool call opens an OAuth sign-in. Sign in with Google, and you are connected.
+A free account needs no card and arrives with a one-time 10,000-token starter grant.
+
+### Claude (web, Desktop, Code)
+
+**Settings → Connectors → Add custom connector**
+
+| Field | Value |
+|---|---|
+| Name | `GetMattered` |
+| Remote MCP server URL | `https://mcp.getmattered.com/mcp` |
+
+In Claude Code, one line does it:
+
+```bash
+claude mcp add --transport http getmattered https://mcp.getmattered.com/mcp
+```
+
+### Cursor
+
+`~/.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "getmattered": {
+      "url": "https://mcp.getmattered.com/mcp"
+    }
+  }
+}
+```
+
+### ChatGPT
+
+**Settings → Connectors → Create** and paste `https://mcp.getmattered.com/mcp`. ChatGPT speaks MCP
+natively, so there is no Action schema to import and nothing to host.
+
+### VS Code
+
+```bash
+code --add-mcp '{"name":"getmattered","type":"http","url":"https://mcp.getmattered.com/mcp"}'
+```
+
+### Plugin for Codex, ChatGPT, Claude Code and Cursor
+
+This repository is a plugin marketplace. The `getmattered` plugin bundles the MCP server with fourteen
+skills, in the portable `plugin.json` format that Codex, ChatGPT, Claude Code and Cursor read:
+
+| Skill | Use it when |
+|---|---|
+| [`using-getmattered`](plugins/getmattered/skills/using-getmattered/SKILL.md) | You want the assistant to pick the right tool and order for your request |
+| [`setup-job-search`](plugins/getmattered/skills/setup-job-search/SKILL.md) | You want to set your base resume, finish your profile or check readiness |
+| [`find-matching-jobs`](plugins/getmattered/skills/find-matching-jobs/SKILL.md) | You want your job matches, want to save or skip one, or want to change what it looks for |
+| [`apply-to-a-job`](plugins/getmattered/skills/apply-to-a-job/SKILL.md) | You want to apply, or you paste a job link and say "apply" |
+| [`review-and-send`](plugins/getmattered/skills/review-and-send/SKILL.md) | You want to see what is waiting for you, change it, and send it |
+| [`tailor-for-a-job`](plugins/getmattered/skills/tailor-for-a-job/SKILL.md) | You want a posting analysis, an ATS score or a resume rewrite for one role |
+| [`track-applications`](plugins/getmattered/skills/track-applications/SKILL.md) | You ask "did it go through", or how many applications you have left |
+| [`write-cover-letter`](plugins/getmattered/skills/write-cover-letter/SKILL.md) | You want a letter for one job or changes to an existing letter |
+| [`prepare-for-interview`](plugins/getmattered/skills/prepare-for-interview/SKILL.md) | You want role-specific questions and to practise answers from your own experience |
+| [`handle-recruiter-replies`](plugins/getmattered/skills/handle-recruiter-replies/SKILL.md) | An employer wrote back and you want to read it and send a reply you approved |
+| [`follow-up-on-applications`](plugins/getmattered/skills/follow-up-on-applications/SKILL.md) | An application has gone quiet and you want to follow up |
+| [`manage-saved-searches`](plugins/getmattered/skills/manage-saved-searches/SKILL.md) | You want to save a search and get emailed about its new jobs |
+| [`translate-resume`](plugins/getmattered/skills/translate-resume/SKILL.md) | You want your resume in another language |
+| [`build-resume-document`](plugins/getmattered/skills/build-resume-document/SKILL.md) | You want a private editable summary draft, with a builder page to review before export |
+
+The hosted skill index is at
+[`getmattered.com/.well-known/agent-skills/index.json`](https://getmattered.com/.well-known/agent-skills/index.json).
+The plugin files are in `plugins/getmattered/skills/`. The root `skills/` link points to that same
+directory so Gemini CLI discovers the workflows without a second set of skill files.
+
+Skills check account limits before metered work and get approval before credit-consuming actions
+or sending an application. Installing a plugin does not buy a GetMattered plan. Public directory
+approval is separate from installing this repository directly.
+
+Codex:
+
+```bash
+codex plugin marketplace add getmattered/getmattered-mcp
+codex plugin add getmattered@getmattered
+```
+
+Claude Code:
+
+```bash
+claude plugin marketplace add getmattered/getmattered-mcp
+claude plugin install getmattered@getmattered
+```
+
+### Codex (CLI, IDE extension and the ChatGPT desktop app)
+
+```bash
+codex mcp add getmattered --url https://mcp.getmattered.com/mcp
+codex mcp login getmattered
+```
+
+The Codex CLI, the IDE extension and the ChatGPT desktop app share this configuration.
+
+### Gemini CLI
+
+This repository is also a Gemini CLI extension (`gemini-extension.json`, `GEMINI.md` and the same
+fourteen skills):
+
+```bash
+gemini extensions install https://github.com/getmattered/getmattered-mcp
+```
+
+Or add the server by hand in `~/.gemini/settings.json`:
+
+```json
+{
+  "mcpServers": {
+    "getmattered": { "httpUrl": "https://mcp.getmattered.com/mcp" }
+  }
+}
+```
+
+### Zed
+
+**Settings → AI → MCP Servers → Add Remote Server**, then paste `https://mcp.getmattered.com/mcp`.
+
+### Windsurf
+
+`~/.codeium/windsurf/mcp_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "getmattered": { "command": "npx", "args": ["-y", "mcp-remote", "https://mcp.getmattered.com/mcp"] }
+  }
+}
+```
+
+### Perplexity, Mistral Le Chat and Raycast
+
+Each has a custom connector screen that takes a remote MCP URL. Paste
+`https://mcp.getmattered.com/mcp` and choose OAuth.
+
+### From your phone: iMessage, Telegram and WhatsApp
+
+- **iMessage / SMS:** [add GetMattered to Poke in one tap](https://poke.com/integrations/new?name=GetMattered&url=https%3A%2F%2Fmcp.getmattered.com%2Fmcp)
+  (or `npx poke@latest mcp add https://mcp.getmattered.com/mcp -n "GetMattered"`), sign in, then text Poke:
+  "find me remote product designer jobs and apply to the best two".
+- **Telegram, WhatsApp or iMessage on your own server:** [OpenClaw](https://github.com/SamurAIGPT/awesome-openclaw)
+  is a self-hosted gateway. Add the URL as an MCP server and enable the channel you use.
+
+### Any client that only speaks stdio
+
+This repository ships a thin bridge. It relays the protocol to the hosted server and adds
+nothing of its own.
+
+```bash
+npx -y github:getmattered/getmattered-mcp
+```
+
+Or with Docker:
+
+```bash
+docker build -t getmattered-mcp .
+docker run --rm -i getmattered-mcp
+```
+
+```json
+{
+  "mcpServers": {
+    "getmattered": {
+      "command": "docker",
+      "args": ["run", "--rm", "-i", "getmattered-mcp"]
+    }
+  }
+}
+```
+
+| Environment variable | Default | Meaning |
+|---|---|---|
+| `GETMATTERED_MCP_URL` | `https://mcp.getmattered.com/mcp` | Endpoint to relay to. Point it at `https://mcp-preview.getmattered.com/mcp` to test against preview, or at `https://mcp.aiapplyd.com/mcp` to reach the old host during the rename. The old name `AIAPPLYD_MCP_URL` is still read when this one is unset. |
+| `GETMATTERED_TOKEN` | unset | Optional bearer token. Without it the server still answers introspection; tool **calls** return 401 until an account is connected. The old name `AIAPPLYD_TOKEN` is still read when this one is unset. |
+
+## Command line and bots
+
+The same package is a small CLI, so a script, a cron job or a chat bot (Telegram, WhatsApp,
+iMessage) can run the whole job search without an MCP client.
+
+```bash
+npx getmattered-mcp login                                    # sign in once in the browser
+npx getmattered-mcp tools                                    # list the tools
+npx getmattered-mcp call getmattered_get_matches '{"limit": 5}' # matched jobs as JSON
+npx getmattered-mcp call getmattered_apply '{"job_match_id": 123, "mode": "review"}'
+npx getmattered-mcp call getmattered_get_applications '{"status": "waiting_for_review"}'
+npx getmattered-mcp call getmattered_review_application '{"decision": "approve", "application_ids": [456]}'
+```
+
+`login` runs the same OAuth sign-in a desktop client runs and stores the token in
+`~/.config/getmattered/credentials.json` (mode 600). It refreshes on its own, so an unattended bot
+keeps working. `call` prints the tool's structured result as JSON. Exit code 0 means success,
+1 means the tool reported an error, 2 means you are not signed in.
+
+Run with no arguments and it is a stdio MCP server that relays to `https://mcp.getmattered.com/mcp`,
+signed in with the stored login. `GETMATTERED_TOKEN` overrides the stored login and
+`GETMATTERED_MCP_URL` overrides the endpoint.
+
+### Renamed from AI Applyd
+
+AI Applyd is now GetMattered, and the npm package `aiapplyd-mcp` is now `getmattered-mcp`.
+Existing setups keep working:
+
+- The package installs two commands, `getmattered-mcp` and the old `aiapplyd-mcp`. Both run the same code.
+- Tool ids are `getmattered_<name>`. `call` also accepts the old `aiapplyd_<name>` ids and runs
+  whichever name the server lists.
+- `GETMATTERED_TOKEN` and `GETMATTERED_MCP_URL` replace `AIAPPLYD_TOKEN` and `AIAPPLYD_MCP_URL`.
+  The old names are still read when the new ones are unset.
+- A sign-in stored by an older version in `~/.config/aiapplyd/credentials.json` is still read.
+  The next `login` or token refresh writes `~/.config/getmattered/credentials.json`.
+
+## Endpoints
+
+| Environment | Streamable HTTP (modern) | SSE (legacy bridges) |
+|---|---|---|
+| Production | `https://mcp.getmattered.com/mcp` | `https://mcp.getmattered.com/sse` |
+| Preview | `https://mcp-preview.getmattered.com/mcp` | `https://mcp-preview.getmattered.com/sse` |
+
+Use `/mcp`. `/sse` remains only for clients that cannot speak Streamable HTTP.
+
+## Tools
+
+The table below is generated from the live `tools/list` of `https://mcp.getmattered.com/mcp`.
+Every tool runs on the caller's own GetMattered account. Reading matches, applications
+and account limits does not run AI generation. AI work and applications use the
+account's allowance. Tool calls require sign-in; introspection is public.
+
+### The main loop
+
+Five tools run the whole job search from a chat, or from a bot where a match drops and you
+reply "yes":
+
+```
+getmattered_get_matches -> getmattered_apply -> getmattered_get_applications -> getmattered_review_application
+                  getmattered_get_account (plan, what is left, readiness)
+```
+
+| Tool | Title | Hints | What it does |
+|---|---|---|---|
+| `getmattered_get_matches` | Get Job Matches | read-only, idempotent | Your matched jobs, best first, each with the `job_match_id` that apply takes. Also reads full postings, or any posting from a link |
+| `getmattered_apply` | Apply to Job | **destructive**, open-world | Apply to one job by `job_match_id` or `job_url` on the employer's own hiring system. `mode: "auto"` sends it, `mode: "review"` holds it for your yes |
+| `getmattered_get_applications` | Get Applications | read-only, idempotent | Every application and where it stands, the review queue, and the employer's own confirmation when it exists |
+| `getmattered_review_application` | Approve or Reject Applications | **destructive**, open-world | Approve (send) or reject waiting applications, up to 25 at once. Also cancel, refine a document, re-prepare, or record the interview stage |
+| `getmattered_get_account` | Get Account | read-only, idempotent | Your plan, token balance, applications left, job preferences, and whether your profile is ready to apply |
+| `getmattered_get_inbox` | Get Recruiter Inbox | read-only, idempotent | The emails employers send about your applications, with the full conversation and suggested replies |
+| `getmattered_reply_to_email` | Reply to an Employer Email | **destructive**, open-world | Sends your reply to an employer from your GetMattered address, only after you approve the exact text |
+| `getmattered_manage_follow_ups` | Follow Up on Applications | **destructive**, open-world | Lists applications that went quiet, drafts a follow-up, and sends it once you approve it |
+
+### Setup and triage
+
+| Tool | Title | Hints | What it does |
+|---|---|---|---|
+| `getmattered_set_resume` | Set Resume | writes, open-world | Put your resume on your account as the base every application is tailored from: pasted text, a file link, or a saved resume |
+| `getmattered_triage_matches` | Save or Skip Matches | writes, idempotent | Save a match, or skip it with a reason, so a job you declined stops coming back |
+| `getmattered_update_job_preferences` | Update Job Preferences | **destructive**, idempotent | Point GetMattered at the roles, locations, salary and seniority you want, and re-run discovery |
+| `getmattered_update_application_profile` | Update Application Profile | writes, idempotent | Reads or saves the answers employer forms ask for. EEO answers are optional and accept prefer not to say |
+| `getmattered_update_auto_apply` | Update Auto Apply | **destructive**, idempotent | Turns Auto Apply on or off and sets whether applications go out on their own or wait for your review |
+| `getmattered_manage_saved_searches` | Manage Saved Searches | writes | Saves your job preferences as named searches, with email alerts for new matches |
+
+### Resume, cover letter and interview
+
+| Tool | Title | Hints | What it does |
+|---|---|---|---|
+| `getmattered_score_resume` | Score Resume | writes, open-world | An ATS score with section scores, the keywords you match and the ones you are missing, and what to change |
+| `getmattered_analyze_job_description` | Analyze Job Description | writes, open-world | What a posting screens on, in its own language, so the resume can mirror it |
+| `getmattered_optimize_resume` | Optimize Resume with AI | writes, open-world | A resume rewritten to pass ATS screening and still reach a human reader |
+| `getmattered_generate_interview_questions` | Generate Interview Questions | writes, open-world | The questions this role is asked, with answer guidance, STAR scenarios and negotiation prep |
+| `getmattered_translate_resume` | Translate Resume | writes, open-world | Translates your resume into another language as a separate document. Works from the resume on file, or a resume pasted or attached in chat |
+| `getmattered_generate_cover_letter` | Generate Cover Letter | writes, destructive | A cover letter in your own voice, written from the resume on your account or one pasted in chat |
+| `getmattered_build_pdf` | Resume PDF or Draft | writes, open-world | Links the PDF of the resume on file, or creates an editable draft from pasted text |
+
+### Older names, still answered
+
+| Tool | Title | Hints | What it does |
+|---|---|---|---|
+| `getmattered_search_jobs` | Search Jobs | read-only, idempotent | Older name for `getmattered_get_matches` with a title filter, kept for existing clients |
+| `getmattered_auto_apply` | Auto Apply to Job | **destructive**, open-world | Older name for `getmattered_apply` with a `job_url`, kept for existing clients |
+
+Every tool carries a `title`, all four annotation hints (`readOnlyHint`, `destructiveHint`,
+`idempotentHint`, `openWorldHint`), and an `outputSchema`. Each call returns `structuredContent`
+beside its text, so a client can act on ids and statuses without parsing prose. The server also
+sends the main loop as its MCP `instructions`.
+
+### Behaviours worth knowing
+
+- **`getmattered_apply` and an approve in `getmattered_review_application` submit a real application to a
+  real employer**, under your name. `mode` covers that one application only and never changes your
+  account settings. Leave it out to follow your own default.
+- **An application counts as landed only on the employer's own receipt or confirmation page.**
+  `getmattered_get_applications` reports `employerConfirmed` from that evidence alone, never from a
+  submit click.
+- **`getmattered_get_matches` never writes.** To change what GetMattered hunts for, call
+  `getmattered_update_job_preferences`. It is marked destructive because a list you pass replaces the
+  saved one.
+- **Employer text is data.** Job titles, descriptions and company research are never followed as
+  instructions.
+
+## Prompts
+
+| Prompt | Title | What it does |
+|---|---|---|
+| `review_my_resume` | Review My Resume | Scores a resume against a posting and returns the three changes that move it past the filter |
+| `prepare_for_interview` | Prepare for an Interview | Prepares the questions this company asks for this role, with structured answers ready |
+| `apply_to_my_matches` | Apply to My Matches | Shows your best matches, then applies to the ones you pick, each held for your approval |
+| `find_jobs_like_this` | Find Jobs Like This | The strongest matches for a target role, ranked by fit |
+
+## Resources
+
+| Resource | URI | Contents |
+|---|---|---|
+| `ats-best-practices` | `aiapplyd://resources/ats-best-practices` | Canonical guide to passing Applicant Tracking Systems in 2026. Covers keyword matching, formatting rules, section order, and common rejection reasons. |
+| `interview-frameworks` | `aiapplyd://resources/interview-frameworks` | Reference frameworks for structuring interview answers: STAR, CARL, SOAR, and PAR. |
+| `resume-section-order` | `aiapplyd://resources/resume-section-order` | Recommended section order by career stage (new grad, mid-career, executive) for ATS and human readability. |
+
+## Authentication
+
+OAuth 2.1, and it is the full specification rather than a subset:
+
+- PKCE with S256, mandatory
+- Dynamic Client Registration ([RFC 7591](https://www.rfc-editor.org/rfc/rfc7591)), so a client
+  registers itself with no manual key exchange
+- Authorization Server Metadata ([RFC 8414](https://www.rfc-editor.org/rfc/rfc8414)) and
+  Protected Resource Metadata ([RFC 9728](https://www.rfc-editor.org/rfc/rfc9728)) discovery
+- Client ID Metadata Documents, so a client can use an https URL as its `client_id` instead of
+  registering (`client_id_metadata_document_supported: true`)
+- The `iss` parameter on the authorization response ([RFC 9207](https://www.rfc-editor.org/rfc/rfc9207))
+- Token revocation ([RFC 7009](https://www.rfc-editor.org/rfc/rfc7009))
+- Short-lived access tokens with rotating refresh tokens and reuse detection
+
+An unauthenticated `tools/call` returns HTTP 401 with a `WWW-Authenticate` header pointing at
+the metadata document. Introspection (`initialize`, `tools/list`, `prompts/list`,
+`resources/list`) is open, so any directory or client can read the tool surface before a user
+signs in.
+
+## Verify it yourself
+
+```bash
+SID=$(curl -s -D- -o /dev/null -X POST https://mcp.getmattered.com/mcp \
+  -H 'Content-Type: application/json' \
+  -H 'Accept: application/json, text/event-stream' \
+  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"probe","version":"1"}}}' \
+  | grep -i '^mcp-session-id' | tr -d '\r' | awk '{print $2}')
+
+curl -s -X POST https://mcp.getmattered.com/mcp \
+  -H 'Content-Type: application/json' \
+  -H 'Accept: application/json, text/event-stream' \
+  -H "Mcp-Session-Id: $SID" \
+  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'
+```
+
+## Privacy
+
+Your resume and profile stay on your GetMattered account. Tools read and write that account and
+nothing else. The [privacy policy](https://getmattered.com/legal/privacy) and
+[terms](https://getmattered.com/legal/terms) are the binding statement.
+
+## Support
+
+- Issues: [github.com/getmattered/getmattered-mcp/issues](https://github.com/getmattered/getmattered-mcp/issues)
+- Email: support@getmattered.com
+
+## Follow GetMattered
+
+- Website: [getmattered.com](https://getmattered.com)
+- Pricing: [getmattered.com/pricing](https://getmattered.com/pricing)
+- Blog: [getmattered.com/blog](https://getmattered.com/blog)
+- X: [@aiapplydHQ](https://x.com/aiapplydHQ)
+- LinkedIn: [GetMattered](https://www.linkedin.com/company/aiapplyd/)
+- YouTube: [@aiapplyd](https://www.youtube.com/@aiapplyd)
+- TikTok: [@aiapplydhq](https://www.tiktok.com/@aiapplydhq)
+- Instagram: [@aiapplyd](https://www.instagram.com/aiapplyd)
+- Discord: [join the community](https://discord.gg/ZXBsKvuvCD)
+
+## About this repository
+
+The hosted server runs on Cloudflare Workers and its source is not public. This repository is
+the public home of the MCP server: the `server.json` manifest, the connection documentation,
+and the small stdio bridge above. The bridge is MIT licensed and forwards messages verbatim,
+so you can read every line of what runs on your machine.
+
+---
+
+## More from GetMattered
+
+- [GetMattered](https://getmattered.com) - auto-apply that ends on an interview
+- [How the MCP server works](https://getmattered.com/mcps) - setup for Claude, ChatGPT and Cursor
+- [Pricing](https://getmattered.com/pricing) - free to start, no card
+- [Blog](https://getmattered.com/blog) - how hiring systems actually screen you
+- [FAQ](https://getmattered.com/faq) - resume parsing, ATS behaviour, what "application received" means
+- [Compare](https://getmattered.com/vs) - GetMattered against the other job-application tools
+- [Four things that cost us money while automating job applications](https://dev.to/aiapplyd/four-things-that-cost-us-money-while-automating-job-applications-1l51) - engineering write-up
+
+Built by [GetMattered](https://getmattered.com). Questions: [ava@getmattered.com](mailto:ava@getmattered.com)