{"id":"dev.getcited/mcp","slug":"dev-getcited-mcp","title":"GetCited","description":"SEO and AI-visibility operator tools: site health, ranked actions, ranks, visitor behavior.","version":"0.2.0","publisher":{"kind":"domain","id":"getcited.dev","label":"getcited.dev","url":"https://getcited.dev"},"website":"https://getcited.dev/docs/mcp","repository":"https://github.com/bapierre/getcited-mcp","remotes":[{"type":"streamable-http","url":"https://app.getcited.dev/api/mcp","headers":[{"description":"Bearer API key created on Settings -> API keys. Format: 'Bearer vseo_...'. Never put the key in the URL.","isRequired":true,"format":"string","isSecret":true,"placeholder":"Bearer vseo_...","name":"Authorization"}]}],"packages":[],"published":"2026-09-20","updated":"2026-09-20","status":"online","auth":"","latency_ms":1527,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"how_to_authenticate","title":"GetCited is not authenticated","description":"This server is not authenticated, so none of its SEO tools will answer. Call this for the exact steps to fix it. Retrying other tools will not help.","read_only":true},{"name":"get_setup_status","title":"Onboarding checklist","description":"The onboarding as a checklist for one project: each step (profile, tech stack, competitors, first audit, keywords, rank check, GEO prompts, GEO check, visitor snippet) with whether it is done, what it needs and the tool that completes it, plus `next`, the first step still open. Call it right after add_project and again after each step until `complete` is true; it reads only, so it is safe to call ","read_only":true},{"name":"list_projects","title":"List projects","description":"Lists the sites this API key can operate on and returns `projects`, newest first, each with id (the projectId every other tool takes), domain and createdAt. Read-only. Sites removed with remove_project are not listed, and an empty array means nothing is tracked yet. To find the site of the codebase you are in, prefer add_project with its domain: it returns that project whether or not it already ex","read_only":true},{"name":"add_project","title":"Track a site","description":"Register the site you are working in, and get its project id back. Pass the domain you derived from this codebase (git remote, deployed URL, site config). Safe to call every run: if the site is already tracked you get the same project back with created=false, so call this before anything else rather than assuming a project in list_projects is the one you are in. It does not crawl: call get_setup_s","read_only":false},{"name":"remove_project","title":"Stop tracking a site","description":"Stop tracking a site: it leaves list_projects, stops being crawled or checked, and frees a site slot on the plan. Nothing is erased. Its crawls, findings and history are kept, and add_project on the same domain brings the same project back with its history intact. Use it for a site you no longer work on, or one you registered by mistake. Returns projectId, domain and removed; calling it again is h","read_only":false},{"name":"get_site_health","title":"Site health","description":"Returns the project's current state: the latest crawl (status, pages crawled, when), issue counts by severity and by rule, the open action count and the scores, where a dimension with no data yet is null rather than 0. Read-only. Call it after run_audit to see whether the crawl finished, and before list_actions for the overview. With no crawl yet latestCrawl is null and the counts are 0: call run_","read_only":true},{"name":"get_next_work","title":"What to do next","description":"The one call an unattended agent needs: the findings worth acting on now, most important first, or an instruction to stand by until a given time. Ordering is severity weighted by the page's own measured traffic. Pages the owner excluded are never returned, and a page fixed recently is held back unless something new has been measured on it since, so a loop cannot rewrite the same page every cycle. ","read_only":true},{"name":"list_actions","title":"List actions","description":"Returns the prioritized problems filed for a project, most urgent first; priority 1 is most urgent, 5 least. Read-only. Defaults to open ones. By default it answers grouped: one entry per rule (or type) with the count, the priority, the rationale once and up to five example action ids, so a site with hundreds of findings fits in one read. Pass ruleId or type (or view: \"rows\") for the individual ac","read_only":true},{"name":"get_action","title":"Get an action","description":"Returns one action in full: type, priority, title, rationale (what was measured and why it matters), targetUrl, status, the claim and closing fields, and `payload`, the evidence (the audit rule id and its measured values, such as the current title and its length; the shape varies by type). Read-only. Use it on the one action you are about to work on; list_actions and get_next_work are for choosing","read_only":true},{"name":"claim_action","title":"Claim an action","description":"Marks an open action as claimed by this API key, so other agents working the same queue skip it, and returns the updated action. Only an open action can be claimed: one already claimed (by any agent, this one included), done or dismissed answers not_found, so a repeat call changes nothing. A claim does not expire and is not a lock: it stays until complete_action or dismiss_action closes the action","read_only":false},{"name":"complete_action","title":"Complete an action","description":"Mark a problem done after you have addressed it in the codebase. Pass `note` to record what you changed; the owner reads it to tell a real fix from a box ticked. Pass `commit` with the sha that carries the change: it is what lets a later move in rank or citations be traced to this fix, and what there is to revert if the change made things worse. When one change closed several findings — an edit to","read_only":false},{"name":"dismiss_action","title":"Dismiss an action","description":"Drop a problem you are deliberately not acting on, and say why. `reason` is required and is shown to the site owner: explain what makes this finding wrong or inapplicable here, in a sentence they could disagree with. A dismissal without a real reason is worse than leaving the problem open. Accepts an open or claimed action and returns it with status dismissed; later refreshes do not file the same ","read_only":false},{"name":"run_audit","title":"Run a site audit","description":"Queues a fresh crawl and audit of the site and returns the crawl id and status, up to maxPages pages (default 100; the response says how many it used). Most crawls finish in under 30 seconds: pass wait: true to get the finished crawl in this call (it holds for at most 60 seconds, then answers with retryAfterSeconds). Without wait it returns at once with the crawl id and retryAfterSeconds; poll get","read_only":false},{"name":"add_keywords","title":"Add keywords","description":"Starts tracking search `terms` for a project and returns `added`, the number of new keywords. Pass terms as an array of plain search phrases (terms: [\"seo tool\", \"rank tracker\"]) with the projectId from add_project or list_projects. Terms are lowercased, and one already tracked is skipped, so calling again is safe. Adding measures no rank: call check_rankings for positions. Search volume and diffi","read_only":false},{"name":"list_keywords","title":"List keywords","description":"Returns `keywords`, one row per tracked keyword, newest first: id (the keywordId rank_history takes), term, country, language, createdAt, `metric` (search volume, cpc, difficulty, fetchedAt) and `rank` (latest position within the top 30, null when the site is not in it, foundUrl, checkedAt, and whether an AI Overview appeared and cited the site). Read-only. metric is null until enrichment lands, a","read_only":true},{"name":"rank_history","title":"Keyword rank history","description":"Pass `keywordId`, which is the id field of an entry from list_keywords, together with the projectId that keyword belongs to. Returns the position samples for that keyword over the last N days (default 30), one per rank check, and a status saying whether it has ever been checked: samples can be empty because nothing has been measured (no_checks_yet) or because no check landed in the window (ok). Ch","read_only":true},{"name":"check_rankings","title":"Check keyword rankings now","description":"Queues a search-position check (top 30 results) for every keyword tracked on this project and returns status, jobId and the keyword count. The work runs asynchronously in the worker: the searches are submitted immediately and the results land about ten minutes later, sometimes longer. This returns as soon as the run is queued, so do not wait on it; poll rank_history (or list_keywords for the lates","read_only":false},{"name":"add_geo_prompts","title":"Add GEO prompts","description":"Pass `prompts` as an array of objects, not strings: each is { prompt: \"best seo tool for agents\", stage?: \"tofu\" | \"mofu\" | \"bofu\", format?: \"keyword\" | \"conversational\" | \"list\" }, with the projectId from add_project or list_projects. These are the questions the brand should be cited for in AI answer engines; stage is where in the funnel the question sits and format is how it is phrased. Returns ","read_only":false},{"name":"geo_summary","title":"GEO visibility summary","description":"Returns how often the site appears in AI answers: one row per tracked prompt, and within it one entry per engine with runs, citedRuns, mentionedRuns, citedRate and mentionedRate, plus the competitor domains cited instead, over the last `days`. Read-only. Frequency over the window is the metric: there is never a per-run rank, and engines are never blended. An empty array means no prompts (add_geo_p","read_only":true},{"name":"check_geo","title":"Check AI answer engines now","description":"Queues a run of every tracked GEO prompt against each configured AI answer engine and returns status, jobId and the prompt count. The work runs asynchronously in the worker and takes minutes; this returns as soon as it is queued. Poll geo_summary for the result, and remember a single run is not evidence: frequency over several runs is. Costs one geo_prompt of quota per prompt per engine, so add_ge","read_only":false},{"name":"refresh_actions","title":"Rebuild the action list","description":"Rebuilds this project's action list from what is already measured (crawl findings, ranks, AI-engine citations, visitor behavior) by fixed rules: no model, no provider call, no quota. Every crawl already triggers one, so call it only after check_rankings or check_geo results have landed and you want them turned into actions now. It measures nothing new: run run_audit, check_rankings or check_geo fi","read_only":false},{"name":"get_behavior_digest","title":"Visitor analytics: traffic, AI referrals, friction","description":"Returns visitor analytics from the site's own traffic over the last `days`: sessions, engaged and bounce rates, channels including AI assistants, top pages, exit pages, statistically flagged high-bounce pages (z-test, n>=30) and friction (rage and dead clicks). Read-only. Needs the vp.js snippet on the site (get_setup_status gives it); without it, or with no traffic in the window, sessions is 0, r","read_only":true},{"name":"set_project_profile","title":"Describe what this site sells","description":"Step one of the growth recipe, and the gate on the rest of it. Record what this site sells in the owner's words: productSummary (a paragraph, at most 600 characters), valueProposition (at most 300), audience (at most 300), plus optional marketCountry and marketLanguage as two lowercase letters (default us and en, and the keyword and rank checks read them) and competitors as an array of at most 5 h","read_only":false},{"name":"get_project_profile","title":"Read the site's profile","description":"The stored profile for a project: the three texts as they were written and where they came from, the market country and language, the tracked competitors, the declared techStack next to the detectedStack the latest crawl saw, whether it is complete, and `missing`, which names the fields that are still empty. Call it before list_opportunities to see whether set_project_profile is needed.","read_only":true},{"name":"list_opportunities","title":"Queries this site does not hold","description":"The opportunity queue: one row per query the site should hold and does not, or holds badly, built only from rows already measured. Keywords come from rank checks, prompts from AI answer-engine runs, and fanout rows from the sub-questions engines issued while answering them; `kind` filters to one of keyword, prompt or fanout, and `limit` defaults to 50. Each row names who holds the query now (the p","read_only":true},{"name":"get_content_brief","title":"Evidence for one query","description":"Evidence for building a page for one query. Contains no wording; what to write is yours. `query` is one row's `query` from list_opportunities, exactly as it came back (a tracked keyword, a tracked prompt, or a fan-out sub-question); anything else answers not_found. You get back: the queue row with the arithmetic that ranked it; the sub-questions engines actually issued while answering the prompt t","read_only":true},{"name":"get_page_history","title":"One page over time","description":"Every measurement that touched one page, newest first, so a change can be matched to its effect. `url` is the full url of a page on the tracked site (https://example.com/guide); `days` defaults to 90. Three kinds of row on one timeline: `crawl` carries the status, word count, JSON-LD types, h1 count, canonical, open-finding count and `changed`, which is true when the page's visible text differs fr","read_only":true},{"name":"list_regressions","title":"What went backwards","description":"What is measurably worse than it was, over the last `days` (default 30). Three kinds: `rank`, a keyword whose best position over the last three checks is at least three places worse than over the three before, or that ranked and no longer does; `citation`, a prompt and engine whose citation rate fell between two consecutive windows of three runs, both of which must be full because AI answers are s","read_only":true},{"name":"get_page_profile","title":"Page behavior profile","description":"Returns the visitor behaviour of one page over the last `days`: pageviews, entries, bounce rate, exits, 50% and 100% scroll rates, average active time, rage and dead clicks, and vsSite, a two-proportion z-test of its bounce rate against the rest of the site (only meaningful with at least 30 entries on each side). Read-only. Needs the vp.js snippet; take the path from get_behavior_digest's topPages","read_only":true}],"server_info":{"name":"getcited","version":"0.4.3"},"category":"marketing","tags":["project","health","agents"],"kind":"remote","source":"registry","submitted":{},"first_party":true,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-09-20","stars":0,"badges":[],"sponsor":null,"page":"https://agentsindex.org/agents/dev-getcited-mcp/"}