{"serverId":"mcp-registry/io.github.maartendmt/seo-perch","tools":[{"name":"set_delivery","fixed":{"name":"set_delivery","description":"Record how a change is delivered, apart from the board status: stage (draft, pr, merged, deployed, live; it only moves forward, except back to draft or null to start over), prUrl (https://github.com/<owner>/<repo>/pull/<n>; alone it moves a draft to stage pr) and liveCheck {url, contains}: an https url on the item's site that serves this text once the change is live. The hub follows the PR to merged hourly (when the workspace has a GitHub token) and ships the item for you (done, or review for ne","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"id":{"type":"integer","maximum":9007199254740991,"description":"deprecated alias of workId","exclusiveMinimum":0},"prUrl":{"anyOf":[{"type":"string","pattern":"^https:\\/\\/github\\.com\\/[A-Za-z0-9-]{1,39}\\/[A-Za-z0-9._-]{1,100}\\/pull\\/[1-9]\\d{0,9}$"},{"type":"null"}]},"stage":{"anyOf":[{"enum":["draft","pr","merged","deployed","live"],"type":"string"},{"type":"null"}]},"workId":{"type":"integer","maximum":9007199254740991,"description":"work item id; one of workId or id is required","exclusiveMinimum":0},"liveCheck":{"anyOf":[{"type":"object","required":["url","contains"],"properties":{"url":{"type":"string","format":"uri","maxLength":2048},"contains":{"type":"string","maxLength":200,"minLength":1}}},{"type":"null"}]},"workItemId":{"type":"integer","maximum":9007199254740991,"description":"alias of workId","exclusiveMinimum":0}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true},"title":"Set delivery of a work item"},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":415,"tokensAfter":415},{"name":"update_agent_profile","fixed":{"name":"update_agent_profile","description":"Say what you take on so the hub hands you the right work: kinds (work kinds you take; empty = any; next_work then offers you unassigned work of these kinds only), tags (skills, max 20; items sharing them prefer you), wakeUrl (a public https url the hub POSTs {event, workItemId, title, reason, url} to when it hands you work; agents with one are preferred for hand-offs; null clears), wakeHours (local hours 0 to 23 in the workspace timezone: the hub then skips the per-item wake and POSTs {event: wo","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"tags":{"type":"array","items":{"type":"string","maxLength":64,"minLength":1},"maxItems":20},"agent":{"type":"string","maxLength":80,"description":"agent:<slug>; defaults to you"},"kinds":{"type":"array","items":{"enum":["task","roadmap","content","fix","research","experiment"],"type":"string"},"maxItems":6},"paused":{"type":"boolean"},"wakeUrl":{"anyOf":[{"type":"string","format":"uri","maxLength":2048},{"type":"null"}]},"takeover":{"type":"boolean"},"wakeHours":{"type":"array","items":{"type":"integer","maximum":23,"minimum":0},"maxItems":24}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true},"title":"Update your agent profile"},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":335,"tokensAfter":335},{"name":"update_geo_prompt","fixed":{"name":"update_geo_prompt","description":"Change tags, intent or value in place. A new text archives this version and creates the next, so results for the old wording stay separate. archived true stops tracking it.","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["id"],"properties":{"id":{"type":"integer","maximum":9007199254740991,"description":"geo prompt id","exclusiveMinimum":0},"tags":{"type":"array","items":{"type":"string","maxLength":64,"minLength":1},"maxItems":30},"text":{"type":"string","maxLength":500,"minLength":3},"value":{"type":"integer","maximum":5,"minimum":1},"intent":{"enum":["what-is","how-to","compare","choose","brand"],"type":"string"},"archived":{"type":"boolean","const":true}}},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true},"title":"Update or archive a GEO prompt"},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: true, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":213,"tokensAfter":213},{"name":"update_knowledge","fixed":{"name":"update_knowledge","description":"Change the status (active, superseded, stale: set a stale item back to active to revive it), kind or recheck date of a knowledge item by id (from search_knowledge). Move run notes and artifact pointers to kind log so searches stay clean; mark outdated items superseded instead of deleting them. Rules and agent roles stay a person's: you cannot change their kind or an active one's status. Title, body and tags changes go through propose_change (the admin approves them); add_knowledge with a differe","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["id"],"properties":{"id":{"type":"integer","maximum":9007199254740991,"description":"knowledge item id","exclusiveMinimum":0},"kind":{"enum":["tip","rule","playbook","checklist","decision","competitor","content_idea","question","agent_role","log","lesson"],"type":"string"},"status":{"enum":["active","superseded","proposed","stale"],"type":"string"},"reviewOn":{"anyOf":[{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},{"type":"null"}]}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true},"title":"Reclassify or retire knowledge"},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":360,"tokensAfter":360},{"name":"update_milestone","fixed":{"name":"update_milestone","description":"Change the title, body, goalId, strategyId or dueDate of a milestone that is still proposed. Planning, ordering, activating and closing milestones is the admin's call.","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["id"],"properties":{"id":{"type":"integer","maximum":9007199254740991,"description":"milestone id","exclusiveMinimum":0},"body":{"type":"string","maxLength":20000},"title":{"type":"string","maxLength":300,"minLength":1},"goalId":{"anyOf":[{"type":"integer","maximum":9007199254740991,"exclusiveMinimum":0},{"type":"null"}]},"dueDate":{"anyOf":[{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},{"type":"null"}]},"strategyId":{"anyOf":[{"type":"integer","maximum":9007199254740991,"exclusiveMinimum":0},{"type":"null"}]}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true},"title":"Edit a proposed milestone"},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":290,"tokensAfter":290},{"name":"update_offsite_listing","fixed":{"name":"update_offsite_listing","description":"Change the url, platform, kind, status or notes of a listing, e.g. planned to submitted. Passing a url and submitted or live checks the page and marks live only for a 2xx page mentioning the brand. Record what you observed; a failed page check only suggests outdated and never changes the status by itself. Agents cannot delete listings: set rejected or outdated.","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["id"],"properties":{"id":{"type":"integer","maximum":9007199254740991,"description":"off-site listing id","exclusiveMinimum":0},"url":{"type":"string","format":"uri","maxLength":2000},"kind":{"enum":["directory","profile","review","publication","listicle","video","podcast","community"],"type":"string"},"notes":{"type":"string","maxLength":2000},"status":{"enum":["planned","submitted","live","outdated","rejected"],"type":"string"},"platform":{"type":"string"}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true},"title":"Update an off-site listing"},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":272,"tokensAfter":272},{"name":"update_strategy","fixed":{"name":"update_strategy","description":"Change the title, thesis, levers, goalIds (replaces them) or reviewOn of a strategy that is still proposed. Activating, pausing and retiring strategies is the admin's call; cite more knowledge with link_knowledge.","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["id"],"properties":{"id":{"type":"integer","maximum":9007199254740991,"description":"strategy id","exclusiveMinimum":0},"title":{"type":"string","maxLength":300,"minLength":1},"levers":{"type":"array","items":{"type":"string","maxLength":300,"minLength":1},"maxItems":20},"thesis":{"type":"string","maxLength":20000},"goalIds":{"type":"array","items":{"type":"integer","maximum":9007199254740991,"exclusiveMinimum":0},"maxItems":20},"reviewOn":{"anyOf":[{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},{"type":"null"}]}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true},"title":"Edit a proposed strategy"},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":303,"tokensAfter":303},{"name":"update_topic","fixed":{"name":"update_topic","description":"On a proposed topic: change name and description, add or change pages (role pillar or supporting; a new pillar demotes the old one), remove pages, add questions and set answer urls. On an active topic you may only add questions and set answers (questionId plus answerUrl, a page on the site; null clears it) once the answering page is live. Activating, archiving, owners and review dates are the admin's call.","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["id"],"properties":{"id":{"type":"integer","maximum":9007199254740991,"description":"topic id","exclusiveMinimum":0},"name":{"type":"string","maxLength":200,"minLength":1},"answers":{"type":"array","items":{"type":"object","required":["questionId","answerUrl"],"properties":{"answerUrl":{"anyOf":[{"type":"string","format":"uri","maxLength":2048},{"type":"null"}]},"questionId":{"type":"integer","maximum":9007199254740991,"exclusiveMinimum":0}}},"default":[],"maxItems":100},"addPages":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri","maxLength":2048},"note":{"type":"string","default":"","maxLength":500},"role":{"enum":["pillar","supporting"],"type":"string","default":"supporting"}}},"default":[],"maxItems":100},"description":{"type":"string","maxLength":4000},"removePages":{"type":"array","items":{"type":"string","format":"uri","maxLength":2048},"default":[],"maxItems":100},"addQuestions":{"type":"array","items":{"type":"string","maxLength":500,"minLength":3},"default":[],"maxItems":100}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true},"title":"Update a topic"},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":449,"tokensAfter":449},{"name":"update_work_status","fixed":{"name":"update_work_status","description":"Move an item between columns: proposed, todo, blocked, done or dropped (doing comes from claim_work). Use ship_work, not done, for work that changed something live: it records the urls so impact is measured and puts work the admin must check in review. Leaving doing releases your claim. Items with needsApproval cannot be done until the admin approves them. With blocked, say why in blockedReason: on_hold (parked), external (waiting on catalog, data or another system) or admin (waiting on a decisi","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["status"],"properties":{"id":{"type":"integer","maximum":9007199254740991,"description":"deprecated alias of workId","exclusiveMinimum":0},"note":{"type":"string","maxLength":4000},"status":{"enum":["proposed","todo","blocked","done","dropped"],"type":"string"},"workId":{"type":"integer","maximum":9007199254740991,"description":"work item id; one of workId or id is required","exclusiveMinimum":0},"wakeWhen":{"type":"string","maxLength":500,"minLength":1,"description":"what would unblock it, e.g. \"catalog feed has prices\""},"recheckAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"or an exact ISO time instead of recheckDays"},"workItemId":{"type":"integer","maximum":9007199254740991,"description":"alias of workId","exclusiveMinimum":0},"recheckDays":{"type":"integer","maximum":90,"minimum":1,"description":"blocked on_hold or external: back to todo after this many days (1 to 90, default 14)"},"blockedReason":{"enum":["on_hold","external","admin"],"type":"string"}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true},"title":"Move a work item"},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":542,"tokensAfter":542}],"toolsChanged":9,"tokensSaved":0,"todo":[{"tool":"add_geo_prompt","params":["tags","text","value","intent"]},{"tool":"add_knowledge","params":["body","kind","tags","title","sources","fingerprint"]},{"tool":"add_offsite_listing","params":["url","kind","site","notes","status","project","platform"]},{"tool":"ask_admin","params":["options","question","recommended"]},{"tool":"check_draft","params":["body","site","title","project","workItemId"]},{"tool":"claim_work","params":["leaseMinutes"]},{"tool":"create_work","params":["ask","body","kind","site","tags","urls","title","value","action","effort","goalId","status","project","assignee","evidence","priority","dedupeKey","dependsOn","findingId","followUpOf","milestoneId","blockedReason","needsApproval","successMetric","expectedImpact"]},{"tool":"expand_keywords","params":["limit"]},{"tool":"get_briefing","params":["format"]},{"tool":"get_impact","params":["limit"]},{"tool":"get_listing_kit","params":["site","project","platform"]},{"tool":"get_metric_series","params":["days"]},{"tool":"get_metrics_summary","params":["days","engine","dimKind","metrics","dimValue"]},{"tool":"keyword_history","params":["days"]},{"tool":"link_knowledge","params":["remove","relation","targetId","targetType","knowledgeId"]},{"tool":"list_activity","params":["type","limit","order","since"]},{"tool":"list_annotations","params":["limit"]},{"tool":"list_brand_facts","params":["site","project"]},{"tool":"list_brand_mentions","params":["limit","source","newOnly"]},{"tool":"list_citation_sources","params":["days","limit"]},{"tool":"list_connector_runs","params":["limit","status"]},{"tool":"list_content_briefs","params":["limit"]},{"tool":"list_findings","params":["group","limit","source","status","severity"]},{"tool":"list_geo_prompts","params":["archived"]},{"tool":"list_goals","params":["status"]},{"tool":"list_inventory","params":["dir","sort","limit","engine","filter"]},{"tool":"list_keywords","params":["days"]},{"tool":"list_messages","params":["limit","since"]},{"tool":"list_milestones","params":["goalId","status","strategyId"]},{"tool":"list_offsite_listings","params":["kind","status"]},{"tool":"list_queries","params":["days","lens","sort","limit","engine"]},{"tool":"list_strategies","params":["goalId","status"]},{"tool":"list_work","params":["kind","tags","limit","goalId","status","milestoneId"]},{"tool":"log_activity","params":["data","site","type","urls","project","summary","workItemId"]},{"tool":"mark_indexing_requested","params":["url"]},{"tool":"next_work","params":["kind","tags","milestoneId","leaseMinutes"]},{"tool":"plan_work","params":["body","title","value","effort","goalId","addTags","assignee","dependsOn","removeTags","milestoneId","successMetric","expectedImpact"]},{"tool":"propose_brand_fact","params":["kind","value","subject","outdated","attribute","sourceUrl"]},{"tool":"propose_change","params":["id","patch","reason","targetType"]},{"tool":"propose_goal","params":["body","title","metric","dueDate","baseline"]},{"tool":"propose_milestone","params":["body","site","title","goalId","dueDate","strategyId"]},{"tool":"propose_strategy","params":["site","title","levers","thesis","goalIds","evidence","reviewOn"]},{"tool":"propose_topic","params":["name","pages","questions","description"]},{"tool":"publish_guide","params":["workId","draftId"]},{"tool":"record_ai_answer","params":["text","model","engine","promptId","citations"]},{"tool":"record_serp_check","params":["notes","query","engine","blocked","results","surface","workItemId"]},{"tool":"reddit_fetch_thread","params":["limit"]},{"tool":"reddit_search","params":["limit","query"]},{"tool":"release_work","params":["note"]},{"tool":"save_draft","params":["body","title"]},{"tool":"search_knowledge","params":["q","kind","site","tags","limit","status","project"]},{"tool":"send_message","params":["to","body","site","workItemId"]},{"tool":"set_delivery","params":["prUrl","stage","liveCheck"]},{"tool":"ship_work","params":["note","urls"]},{"tool":"suggest_geo_prompts","params":["limit"]},{"tool":"suggest_keywords","params":["limit"]},{"tool":"track_keywords","params":["tags","keywords","targetUrl"]},{"tool":"update_agent_profile","params":["tags","kinds","paused","wakeUrl","takeover","wakeHours"]},{"tool":"update_finding_status","params":["status"]},{"tool":"update_geo_prompt","params":["tags","text","value","intent","archived"]},{"tool":"update_knowledge","params":["kind","status","reviewOn"]},{"tool":"update_milestone","params":["body","title","goalId","dueDate","strategyId"]},{"tool":"update_offsite_listing","params":["url","kind","notes","status","platform"]},{"tool":"update_strategy","params":["title","levers","thesis","goalIds","reviewOn"]},{"tool":"update_topic","params":["name","answers","addPages","description","removePages","addQuestions"]},{"tool":"update_work_status","params":["note","status","blockedReason"]}],"note":"Deterministic fixes. Changes marked verify need a human look before shipping (renames, inferred annotations, inferred types, removed text). Parameter descriptions in `todo` need to be written by someone who knows the API."}