Epovest

{
  "annotations": {
    "openWorldHint": false,
    "readOnlyHint": true
  },
  "capabilities": [
    "read"
  ],
  "input_schema": {
    "properties": {
      "project_id": {
        "description": "Only the trackers of this project: the UUID of a project of the account (call list_projects), or \"default\" for the trackers without a project. Omitted, every tracker is listed.",
        "type": "string"
      }
    },
    "type": "object"
  },
  "risk_flags": []
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": false,
    "openWorldHint": false,
    "readOnlyHint": false
  },
  "capabilities": [
    "write"
  ],
  "input_schema": {
    "properties": {
      "analysts": {
        "description": "The lenses that score every survey. keyword_presence and share_of_voice are deterministic; sentiment and custom_prompt are AI analysts billed per analyzed response.",
        "items": {
          "enum": [
            "keyword_presence",
            "share_of_voice",
            "sentiment",
            "custom_prompt"
          ],
          "type": "string"
        },
        "type": "array"
      },
      "custom_prompt": {
        "description": "The instruction of the custom_prompt analyst. Required when that analyst is selected.",
        "type": "string"
      },
      "discovery": {
        "description": "Suggest new keywords spotted in the answers.",
        "type": "boolean"
      },
      "engines": {
        "description": "The AI engines surveyed.",
        "items": {
          "enum": [
            "chatgpt",
            "claude",
            "gemini",
            "perplexity",
            "mistral",
            "grok"
          ],
          "type": "string"
        },
        "type": "array"
      },
      "frequency": {
        "description": "How often a survey runs.",
        "enum": [
          "monthly",
          "weekly",
          "daily"
        ],
        "type": "string"
      },
      "keywords": {
        "description": "Names to detect in the answers: your brand and the names you compare against. Flag yours as favorite.",
        "items": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "properties": {
                "favorite": {
                  "type": "boolean"
                },
                "keyword": {
                  "type": "string"
                }
              },
              "required": [
                "keyword"
              ],
              "type": "object"
            }
          ]
        },
        "type": "array"
      },
      "next_survey_at": {
        "description": "When the next survey runs, ISO 8601, strictly in the future; read as UTC without an offset. Later surveys keep that day and time at the pace of the frequency.",
        "type": "string"
      },
      "notify_on_survey": {
        "description": "Email the account owner and managers each time a survey closes with fresh data, so the results reach them on their own. On by default; send false to keep this tracker silent.",
        "type": "boolean"
      },
      "project_id": {
        "description": "The project the tracker is filed under: the UUID of a project of the account (call list_projects), or \"default\" for none. Pure organization, editable at any time. Omitted on creation the tracker files under Default; omitted on update the project does not change.",
        "type": "string"
      },
      "prompts": {
        "description": "The questions asked to the AI engines at every survey, phrased exactly as a customer would ask them.",
        "items": {
          "type": "string"
        },
        "type": "array"
      },
      "resolution": {
        "description": "Repetitions of every question per engine and survey: hd=1, full_hd=3, 4k=6, 8k=9. Answers are stochastic; more repetitions sharpen the rates.",
        "enum": [
          "hd",
          "full_hd",
          "4k",
          "8k"
        ],
        "type": "string"
      },
      "title": {
        "description": "Display name of the tracker.",
        "type": "string"
      }
    },
    "required": [
      "title",
      "prompts",
      "engines",
      "frequency",
      "resolution"
    ],
    "type": "object"
  },
  "risk_flags": [
    "freeform_input_surface"
  ]
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": false,
    "openWorldHint": false,
    "readOnlyHint": false
  },
  "capabilities": [
    "write"
  ],
  "input_schema": {
    "properties": {
      "analysts": {
        "description": "The lenses that score every survey. keyword_presence and share_of_voice are deterministic; sentiment and custom_prompt are AI analysts billed per analyzed response.",
        "items": {
          "enum": [
            "keyword_presence",
            "share_of_voice",
            "sentiment",
            "custom_prompt"
          ],
          "type": "string"
        },
        "type": "array"
      },
      "custom_prompt": {
        "description": "The instruction of the custom_prompt analyst. Required when that analyst is selected.",
        "type": "string"
      },
      "discovery": {
        "description": "Suggest new keywords spotted in the answers.",
        "type": "boolean"
      },
      "engines": {
        "description": "The AI engines surveyed.",
        "items": {
          "enum": [
            "chatgpt",
            "claude",
            "gemini",
            "perplexity",
            "mistral",
            "grok"
          ],
          "type": "string"
        },
        "type": "array"
      },
      "frequency": {
        "description": "How often a survey runs.",
        "enum": [
          "monthly",
          "weekly",
          "daily"
        ],
        "type": "string"
      },
      "keywords": {
        "description": "Names to detect in the answers: your brand and the names you compare against. Flag yours as favorite.",
        "items": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "properties": {
                "favorite": {
                  "type": "boolean"
                },
                "keyword": {
                  "type": "string"
                }
              },
              "required": [
                "keyword"
              ],
              "type": "object"
            }
          ]
        },
        "type": "array"
      },
      "next_survey_at": {
        "description": "When the next survey runs, ISO 8601, strictly in the future; read as UTC without an offset. Later surveys keep that day and time at the pace of the frequency.",
        "type": "string"
      },
      "notify_on_survey": {
        "description": "Email the account owner and managers each time a survey closes with fresh data, so the results reach them on their own. On by default; send false to keep this tracker silent.",
        "type": "boolean"
      },
      "project_id": {
        "description": "The project the tracker is filed under: the UUID of a project of the account (call list_projects), or \"default\" for none. Pure organization, editable at any time. Omitted on creation the tracker files under Default; omitted on update the project does not change.",
        "type": "string"
      },
      "prompts": {
        "description": "The questions asked to the AI engines at every survey, phrased exactly as a customer would ask them.",
        "items": {
          "type": "string"
        },
        "type": "array"
      },
      "resolution": {
        "description": "Repetitions of every question per engine and survey: hd=1, full_hd=3, 4k=6, 8k=9. Answers are stochastic; more repetitions sharpen the rates.",
        "enum": [
          "hd",
          "full_hd",
          "4k",
          "8k"
        ],
        "type": "string"
      },
      "title": {
        "description": "Display name of the tracker.",
        "type": "string"
      },
      "tracker_id": {
        "description": "The UUID of the tracker: call list_trackers to find it.",
        "format": "uuid",
        "type": "string"
      }
    },
    "required": [
      "tracker_id"
    ],
    "type": "object"
  },
  "risk_flags": [
    "freeform_input_surface"
  ]
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false,
    "readOnlyHint": false
  },
  "capabilities": [
    "undetermined"
  ],
  "input_schema": {
    "properties": {
      "tracker_id": {
        "description": "The UUID of the tracker: call list_trackers to find it.",
        "format": "uuid",
        "type": "string"
      }
    },
    "required": [
      "tracker_id"
    ],
    "type": "object"
  },
  "risk_flags": []
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": false,
    "openWorldHint": false,
    "readOnlyHint": false
  },
  "capabilities": [
    "undetermined"
  ],
  "input_schema": {
    "properties": {
      "tracker_id": {
        "description": "The UUID of the tracker: call list_trackers to find it.",
        "format": "uuid",
        "type": "string"
      }
    },
    "required": [
      "tracker_id"
    ],
    "type": "object"
  },
  "risk_flags": []
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false,
    "readOnlyHint": false
  },
  "capabilities": [
    "undetermined"
  ],
  "input_schema": {
    "properties": {
      "tracker_id": {
        "description": "The UUID of the tracker: call list_trackers to find it.",
        "format": "uuid",
        "type": "string"
      }
    },
    "required": [
      "tracker_id"
    ],
    "type": "object"
  },
  "risk_flags": []
}

{
  "annotations": {
    "destructiveHint": true,
    "idempotentHint": true,
    "openWorldHint": false,
    "readOnlyHint": false
  },
  "capabilities": [
    "write",
    "delete"
  ],
  "input_schema": {
    "properties": {
      "archived": {
        "description": "true files the tracker away and pauses its measurement, false brings it back. Omitted, it files it away.",
        "type": "boolean"
      },
      "tracker_id": {
        "description": "The UUID of the tracker: call list_trackers to find it.",
        "format": "uuid",
        "type": "string"
      }
    },
    "required": [
      "tracker_id"
    ],
    "type": "object"
  },
  "risk_flags": [
    "destructive_operation"
  ]
}

{
  "annotations": {
    "openWorldHint": false,
    "readOnlyHint": true
  },
  "capabilities": [
    "read"
  ],
  "input_schema": {
    "properties": {},
    "type": "object"
  },
  "risk_flags": []
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": false,
    "openWorldHint": false,
    "readOnlyHint": false
  },
  "capabilities": [
    "write"
  ],
  "input_schema": {
    "properties": {
      "canon_address": {
        "description": "Postal address, as written on a listing. Language-neutral: the same string everywhere, like the other facts.",
        "type": "string"
      },
      "canon_category": {
        "description": "Category label for listings and structured data.",
        "type": "string"
      },
      "canon_email": {
        "description": "Public email address of the brand.",
        "type": "string"
      },
      "canon_language": {
        "description": "Short code of the ONE language the canon is written in, like \"en\" or \"pt-br\". The canonical language settles every language call (the llms.txt of a multilingual site is written in it). It travels WITH a wording: the canon is the wording, so sending the language on its own does not open one.",
        "type": "string"
      },
      "canon_legal_name": {
        "description": "Registered name of the company that operates the brand, with its jurisdiction when the user states it (\"Acme Holdings, LLC, Delaware, United States\"). Language-neutral, like the other facts: the AIs cross-read it to anchor the entity, and it is what a directory listing and an Organization.legalName block copy.",
        "type": "string"
      },
      "canon_long": {
        "description": "The two-sentence version, when the surface allows it.",
        "type": "string"
      },
      "canon_one_liner": {
        "description": "One-sentence signature of the brand.",
        "type": "string"
      },
      "canon_perks": {
        "description": "The distinctive claims of the brand, in the order they should be hammered, written in the canonical language. Facts that hold and can be corroborated (\"works without a subscription\"), never superlatives (\"the best\"), which no page reuses. A sent list REPLACES the previous one.",
        "items": {
          "type": "string"
        },
        "type": "array"
      },
      "canon_phone": {
        "description": "Phone number, international prefix included.",
        "type": "string"
      },
      "canon_short": {
        "description": "THE one-sentence description third-party pages reuse as is.",
        "type": "string"
      },
      "canon_website": {
        "description": "The canonical address of the brand website, the one that identifies the entity. A bare domain is enough (\"example.com\" completes to \"https://example.com\"). ONE URL only: the other addresses of the brand (documentation, application, blog, social accounts) are SURFACES, never a second canonical site.",
        "type": "string"
      },
      "canon_whatsapp": {
        "description": "WhatsApp number, international prefix included.",
        "type": "string"
      },
      "name": {
        "description": "Name of the project, as the user calls it (a client, a brand, a website...).",
        "type": "string"
      }
    },
    "required": [
      "name"
    ],
    "type": "object"
  },
  "risk_flags": []
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false,
    "readOnlyHint": false
  },
  "capabilities": [
    "undetermined"
  ],
  "input_schema": {
    "properties": {
      "name": {
        "description": "The name the project takes, as the user calls it (a client, a brand, a website...).",
        "type": "string"
      },
      "project_id": {
        "description": "UUID of the project: call list_projects to find it.",
        "format": "uuid",
        "type": "string"
      }
    },
    "required": [
      "project_id",
      "name"
    ],
    "type": "object"
  },
  "risk_flags": []
}

{
  "annotations": {
    "openWorldHint": false,
    "readOnlyHint": true
  },
  "capabilities": [
    "read"
  ],
  "input_schema": {
    "properties": {
      "project_id": {
        "description": "UUID of the project: call list_projects to find it.",
        "format": "uuid",
        "type": "string"
      }
    },
    "required": [
      "project_id"
    ],
    "type": "object"
  },
  "risk_flags": []
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false,
    "readOnlyHint": false
  },
  "capabilities": [
    "write"
  ],
  "input_schema": {
    "properties": {
      "canon_address": {
        "description": "Postal address, as written on a listing. Language-neutral: the same string everywhere, like the other facts.",
        "type": "string"
      },
      "canon_category": {
        "description": "Category label for listings and structured data.",
        "type": "string"
      },
      "canon_email": {
        "description": "Public email address of the brand.",
        "type": "string"
      },
      "canon_language": {
        "description": "Short code of the ONE language the canon is written in, like \"en\" or \"pt-br\". On a project whose canon is not posted yet, send it with at least one wording: the canon is the wording, and the language on its own does not open one.",
        "type": "string"
      },
      "canon_legal_name": {
        "description": "Registered name of the company that operates the brand, with its jurisdiction when the user states it (\"Acme Holdings, LLC, Delaware, United States\"). Language-neutral, like the other facts: the AIs cross-read it to anchor the entity, and it is what a directory listing and an Organization.legalName block copy.",
        "type": "string"
      },
      "canon_long": {
        "description": "The two-sentence version, when the surface allows it.",
        "type": "string"
      },
      "canon_one_liner": {
        "description": "One-sentence signature of the brand.",
        "type": "string"
      },
      "canon_perks": {
        "description": "The distinctive claims of the brand, in the order they should be hammered, written in the canonical language. Facts that hold and can be corroborated (\"works without a subscription\"), never superlatives (\"the best\"), which no page reuses. A sent list REPLACES the previous one.",
        "items": {
          "type": "string"
        },
        "type": "array"
      },
      "canon_phone": {
        "description": "Phone number, international prefix included.",
        "type": "string"
      },
      "canon_short": {
        "description": "THE one-sentence description third-party pages reuse as is.",
        "type": "string"
      },
      "canon_website": {
        "description": "The canonical address of the brand website, the one that identifies the entity. A bare domain is enough (\"example.com\" completes to \"https://example.com\"). ONE URL only: the other addresses of the brand (documentation, application, blog, social accounts) are SURFACES, never a second canonical site.",
        "type": "string"
      },
      "canon_whatsapp": {
        "description": "WhatsApp number, international prefix included.",
        "type": "string"
      },
      "project_id": {
        "description": "UUID of the project: call list_projects to find it.",
        "type": "string"
      }
    },
    "required": [
      "project_id"
    ],
    "type": "object"
  },
  "risk_flags": []
}

{
  "annotations": {
    "openWorldHint": false,
    "readOnlyHint": true
  },
  "capabilities": [
    "read"
  ],
  "input_schema": {
    "properties": {
      "project_id": {
        "description": "UUID of the project: call list_projects to find it.",
        "format": "uuid",
        "type": "string"
      }
    },
    "required": [
      "project_id"
    ],
    "type": "object"
  },
  "risk_flags": []
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false,
    "readOnlyHint": false
  },
  "capabilities": [
    "write"
  ],
  "input_schema": {
    "properties": {
      "link_targets": {
        "description": "The FULL list of the free addresses, as absolute http(s) URLs. It replaces the previous one.",
        "items": {
          "type": "string"
        },
        "type": "array"
      },
      "project_id": {
        "description": "UUID of the project: call list_projects to find it.",
        "format": "uuid",
        "type": "string"
      }
    },
    "required": [
      "project_id",
      "link_targets"
    ],
    "type": "object"
  },
  "risk_flags": []
}

{
  "annotations": {
    "destructiveHint": true,
    "idempotentHint": true,
    "openWorldHint": false,
    "readOnlyHint": false
  },
  "capabilities": [
    "write",
    "delete"
  ],
  "input_schema": {
    "properties": {
      "archived": {
        "description": "true files the project away, false brings it back. Omitted, it files it away.",
        "type": "boolean"
      },
      "project_id": {
        "description": "UUID of the project: call list_projects to find it.",
        "format": "uuid",
        "type": "string"
      }
    },
    "required": [
      "project_id"
    ],
    "type": "object"
  },
  "risk_flags": [
    "destructive_operation"
  ]
}

{
  "annotations": {
    "openWorldHint": false,
    "readOnlyHint": true
  },
  "capabilities": [
    "read"
  ],
  "input_schema": {
    "properties": {
      "deleted": {
        "description": "Set to \"only\" for the surfaces taken out of the registry (delete_surface), most recently taken out first, each with its deleted_at. Omitted, the registry is listed.",
        "enum": [
          "only"
        ],
        "type": "string"
      },
      "project_id": {
        "description": "UUID of the project: call list_projects to find it.",
        "format": "uuid",
        "type": "string"
      },
      "sort": {
        "description": "Order of the registry. \"registry\", the default, is the order of the binder, by shown name, the one where a known line is found again. \"authority\" orders by the measured authority of the DOMAIN of each line, the most read first, so the work follows a measured fact rather than the tidiness of a checkbox. It orders and never filters: every surface stays listed, the domains off the map closing the list, and a page nobody cites yet is sometimes exactly the one to work on.",
        "enum": [
          "registry",
          "authority"
        ],
        "type": "string"
      }
    },
    "required": [
      "project_id"
    ],
    "type": "object"
  },
  "risk_flags": []
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": false,
    "openWorldHint": false,
    "readOnlyHint": false
  },
  "capabilities": [
    "write",
    "network"
  ],
  "input_schema": {
    "properties": {
      "label": {
        "description": "Display name of the surface. OMIT IT on creation: it is derived from the url (the handle on a known place, the host and path on a website).",
        "type": "string"
      },
      "languages": {
        "description": "Languages of the surface, as short codes like \"en\" or \"pt-br\". A sent list replaces the previous one.",
        "items": {
          "type": "string"
        },
        "type": "array"
      },
      "notes": {
        "description": "Free registry notes: who owns the account, access, context.",
        "type": "string"
      },
      "project_id": {
        "description": "UUID of the project: call list_projects to find it.",
        "format": "uuid",
        "type": "string"
      },
      "type": {
        "description": "What kind of surface this is; it picks the checklist to come. OMIT IT on creation: the type is derived from the url by the catalogue of places (github.com is GitHub, an unknown host is the brand website). Send it only to correct a derivation. \"other\" covers anything else and carries the generic checklist.",
        "enum": [
          "website",
          "github",
          "linkedin",
          "x",
          "youtube",
          "wikidata",
          "directory",
          "app_store",
          "other"
        ],
        "type": "string"
      },
      "url": {
        "description": "Absolute http(s) address of the surface.",
        "type": "string"
      }
    },
    "required": [
      "project_id",
      "url"
    ],
    "type": "object"
  },
  "risk_flags": [
    "arbitrary_network_egress",
    "freeform_input_surface"
  ]
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false,
    "readOnlyHint": false
  },
  "capabilities": [
    "write",
    "network"
  ],
  "input_schema": {
    "properties": {
      "label": {
        "description": "Display name of the surface. OMIT IT on creation: it is derived from the url (the handle on a known place, the host and path on a website).",
        "type": "string"
      },
      "languages": {
        "description": "Languages of the surface, as short codes like \"en\" or \"pt-br\". A sent list replaces the previous one.",
        "items": {
          "type": "string"
        },
        "type": "array"
      },
      "notes": {
        "description": "Free registry notes: who owns the account, access, context.",
        "type": "string"
      },
      "surface_id": {
        "description": "The UUID of the surface: call list_surfaces to find it.",
        "format": "uuid",
        "type": "string"
      },
      "type": {
        "description": "What kind of surface this is; it picks the checklist to come. OMIT IT on creation: the type is derived from the url by the catalogue of places (github.com is GitHub, an unknown host is the brand website). Send it only to correct a derivation. \"other\" covers anything else and carries the generic checklist.",
        "enum": [
          "website",
          "github",
          "linkedin",
          "x",
          "youtube",
          "wikidata",
          "directory",
          "app_store",
          "other"
        ],
        "type": "string"
      },
      "url": {
        "description": "Absolute http(s) address of the surface.",
        "type": "string"
      }
    },
    "required": [
      "surface_id"
    ],
    "type": "object"
  },
  "risk_flags": [
    "arbitrary_network_egress",
    "freeform_input_surface"
  ]
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false,
    "readOnlyHint": false
  },
  "capabilities": [
    "write"
  ],
  "input_schema": {
    "properties": {
      "surface_id": {
        "description": "The UUID of the surface: call list_surfaces to find it.",
        "format": "uuid",
        "type": "string"
      },
      "ticks": {
        "description": "The cell moves. Nothing else on the checklist changes.",
        "items": {
          "properties": {
            "dismissed": {
              "description": "true sets the cell aside (a \"reason\" is due), false brings it back to blank. Never combined with done.",
              "type": "boolean"
            },
            "done": {
              "description": "true verifies the cell, false clears it. Omitted (and no dismissed), it verifies.",
              "type": "boolean"
            },
            "item": {
              "description": "The item, exactly as listed by list_surfaces in checklist.items for the type of this surface.",
              "type": "string"
            },
            "language": {
              "description": "The language the cell belongs to, among the columns listed in checklist.state (\"default\" when the surface lists no language). Omitted, the single column of the surface is used; a multilingual surface needs it on every per-language item. A site-wide item (checklist.site_items) is one cell for the whole site: leave the language out.",
              "type": "string"
            },
            "reason": {
              "description": "Why the item does not apply on this surface, short: the exception must be readable without its author. Due when dismissed is true.",
              "type": "string"
            }
          },
          "required": [
            "item"
          ],
          "type": "object"
        },
        "type": "array"
      }
    },
    "required": [
      "surface_id",
      "ticks"
    ],
    "type": "object"
  },
  "risk_flags": []
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false,
    "readOnlyHint": false
  },
  "capabilities": [
    "write"
  ],
  "input_schema": {
    "properties": {
      "label": {
        "description": "What the check says, as the person would read it on their checklist: one line, up to 120 characters (\"The FAQ block quotes the canon boilerplate\").",
        "type": "string"
      },
      "restates_canon": {
        "description": "true when the check restates the WORDING of the canon, so its verification perishes when the wording moves. false by default, for a check that constates something else.",
        "type": "boolean"
      },
      "scope": {
        "description": "How many cells the check gets: \"language\" by default, one per language of the surface; \"site\" for what exists once for the whole site whatever the number of languages.",
        "enum": [
          "site",
          "language"
        ],
        "type": "string"
      },
      "surface_id": {
        "description": "The UUID of the surface: call list_surfaces to find it.",
        "format": "uuid",
        "type": "string"
      }
    },
    "required": [
      "surface_id",
      "label"
    ],
    "type": "object"
  },
  "risk_flags": []
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false,
    "readOnlyHint": false
  },
  "capabilities": [
    "write"
  ],
  "input_schema": {
    "properties": {
      "check": {
        "description": "The key of the check of your own, exactly as listed by list_surfaces in checklist.custom (add_surface_check returns it too).",
        "type": "string"
      },
      "label": {
        "description": "The new wording of the check, up to 120 characters.",
        "type": "string"
      },
      "restates_canon": {
        "description": "true when the check restates the WORDING of the canon, false when it constates something else.",
        "type": "boolean"
      },
      "surface_id": {
        "description": "The UUID of the surface: call list_surfaces to find it.",
        "format": "uuid",
        "type": "string"
      }
    },
    "required": [
      "surface_id",
      "check"
    ],
    "type": "object"
  },
  "risk_flags": []
}

{
  "annotations": {
    "destructiveHint": true,
    "idempotentHint": true,
    "openWorldHint": false,
    "readOnlyHint": false
  },
  "capabilities": [
    "write",
    "delete"
  ],
  "input_schema": {
    "properties": {
      "check": {
        "description": "The key of the check of your own, exactly as listed by list_surfaces in checklist.custom (add_surface_check returns it too).",
        "type": "string"
      },
      "surface_id": {
        "description": "The UUID of the surface: call list_surfaces to find it.",
        "format": "uuid",
        "type": "string"
      }
    },
    "required": [
      "surface_id",
      "check"
    ],
    "type": "object"
  },
  "risk_flags": [
    "destructive_operation"
  ]
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false,
    "readOnlyHint": false
  },
  "capabilities": [
    "undetermined"
  ],
  "input_schema": {
    "properties": {
      "check": {
        "description": "The key of the check of your own, exactly as listed by list_surfaces in checklist.custom (add_surface_check returns it too).",
        "type": "string"
      },
      "surface_id": {
        "description": "The UUID of the surface: call list_surfaces to find it.",
        "format": "uuid",
        "type": "string"
      }
    },
    "required": [
      "surface_id",
      "check"
    ],
    "type": "object"
  },
  "risk_flags": []
}

{
  "annotations": {
    "destructiveHint": true,
    "idempotentHint": true,
    "openWorldHint": false,
    "readOnlyHint": false
  },
  "capabilities": [
    "write",
    "delete"
  ],
  "input_schema": {
    "properties": {
      "surface_id": {
        "description": "The UUID of the surface: call list_surfaces to find it.",
        "format": "uuid",
        "type": "string"
      }
    },
    "required": [
      "surface_id"
    ],
    "type": "object"
  },
  "risk_flags": [
    "destructive_operation"
  ]
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false,
    "readOnlyHint": false
  },
  "capabilities": [
    "undetermined"
  ],
  "input_schema": {
    "properties": {
      "surface_id": {
        "description": "The UUID of the surface: call list_surfaces to find it.",
        "format": "uuid",
        "type": "string"
      }
    },
    "required": [
      "surface_id"
    ],
    "type": "object"
  },
  "risk_flags": []
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false,
    "readOnlyHint": false
  },
  "capabilities": [
    "undetermined"
  ],
  "input_schema": {
    "properties": {
      "surface_id": {
        "description": "The UUID of the surface: call list_surfaces to find it.",
        "format": "uuid",
        "type": "string"
      }
    },
    "required": [
      "surface_id"
    ],
    "type": "object"
  },
  "risk_flags": []
}

{
  "annotations": {
    "openWorldHint": false,
    "readOnlyHint": true
  },
  "capabilities": [
    "read"
  ],
  "input_schema": {
    "properties": {
      "project_id": {
        "description": "UUID of the project: call list_projects to find it.",
        "format": "uuid",
        "type": "string"
      }
    },
    "required": [
      "project_id"
    ],
    "type": "object"
  },
  "risk_flags": []
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": false,
    "openWorldHint": false,
    "readOnlyHint": false
  },
  "capabilities": [
    "write",
    "network"
  ],
  "input_schema": {
    "properties": {
      "label": {
        "description": "Display name of the page. OMIT IT: it is derived from the address (domain and path). Send an empty string to go back to the derived one.",
        "type": "string"
      },
      "notes": {
        "description": "Free notes: the passage that mentions the brand, the contact, how the page came about.",
        "type": "string"
      },
      "project_id": {
        "description": "UUID of the project: call list_projects to find it.",
        "format": "uuid",
        "type": "string"
      },
      "published_on": {
        "description": "The day the page was PUBLISHED, as YYYY-MM-DD. Distinct from the recording day, and the one that means something against the citation curves. Omit it when unknown: it is never guessed.",
        "type": "string"
      },
      "request_channel": {
        "description": "Whether someone can be asked to change the page: \"available\" (a contact or a process exists), \"none\" (nobody to ask), \"unknown\" (not filled in, the default). It gates the refresh suggestions of the quest file; the contact itself belongs in the notes.",
        "enum": [
          "available",
          "none",
          "unknown"
        ],
        "type": "string"
      },
      "url": {
        "description": "Absolute http(s) address of the EXACT page where the third party talks about the brand, never the home page of the site.",
        "type": "string"
      }
    },
    "required": [
      "project_id",
      "url"
    ],
    "type": "object"
  },
  "risk_flags": [
    "arbitrary_network_egress",
    "freeform_input_surface"
  ]
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false,
    "readOnlyHint": false
  },
  "capabilities": [
    "write",
    "network"
  ],
  "input_schema": {
    "properties": {
      "corroboration_id": {
        "description": "The UUID of the corroboration: call list_corroborations to find it.",
        "format": "uuid",
        "type": "string"
      },
      "label": {
        "description": "Display name of the page. OMIT IT: it is derived from the address (domain and path). Send an empty string to go back to the derived one.",
        "type": "string"
      },
      "monitoring": {
        "description": "How often the page is read again on its own: \"off\" (the default), \"daily\", \"weekly\" or \"monthly\". Each executed check costs 0.02 USD from the prepaid balance and returns the same two findings as verify_corroboration, on the mention and on the link, plus an email when the text of the passage changed or the link is gone. It states a STATE, so sending the same value again does nothing. It applies to a live line whose page reads (readability \"html\"): elsewhere the reply is 409 corroboration_archived or 409 page_not_readable, and \"off\" is always accepted.",
        "enum": [
          "off",
          "daily",
          "weekly",
          "monthly"
        ],
        "type": "string"
      },
      "notes": {
        "description": "Free notes: the passage that mentions the brand, the contact, how the page came about.",
        "type": "string"
      },
      "published_on": {
        "description": "The day the page was PUBLISHED, as YYYY-MM-DD. Distinct from the recording day, and the one that means something against the citation curves. Omit it when unknown: it is never guessed.",
        "type": "string"
      },
      "request_channel": {
        "description": "Whether someone can be asked to change the page: \"available\" (a contact or a process exists), \"none\" (nobody to ask), \"unknown\" (not filled in, the default). It gates the refresh suggestions of the quest file; the contact itself belongs in the notes.",
        "enum": [
          "available",
          "none",
          "unknown"
        ],
        "type": "string"
      },
      "url": {
        "description": "Absolute http(s) address of the EXACT page where the third party talks about the brand, never the home page of the site.",
        "type": "string"
      }
    },
    "required": [
      "corroboration_id"
    ],
    "type": "object"
  },
  "risk_flags": [
    "arbitrary_network_egress",
    "freeform_input_surface"
  ]
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false,
    "readOnlyHint": false
  },
  "capabilities": [
    "write"
  ],
  "input_schema": {
    "properties": {
      "archived": {
        "description": "true takes the page down, false puts it back live. Omitted, it takes it down.",
        "type": "boolean"
      },
      "corroboration_id": {
        "description": "The UUID of the corroboration: call list_corroborations to find it.",
        "format": "uuid",
        "type": "string"
      }
    },
    "required": [
      "corroboration_id"
    ],
    "type": "object"
  },
  "risk_flags": []
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": true,
    "readOnlyHint": false
  },
  "capabilities": [
    "network"
  ],
  "input_schema": {
    "properties": {
      "corroboration_id": {
        "description": "The UUID of the corroboration: call list_corroborations to find it.",
        "format": "uuid",
        "type": "string"
      }
    },
    "required": [
      "corroboration_id"
    ],
    "type": "object"
  },
  "risk_flags": [
    "arbitrary_network_egress"
  ]
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false,
    "readOnlyHint": false
  },
  "capabilities": [
    "undetermined"
  ],
  "input_schema": {
    "properties": {
      "corroboration_id": {
        "description": "The UUID of the corroboration: call list_corroborations to find it.",
        "format": "uuid",
        "type": "string"
      }
    },
    "required": [
      "corroboration_id"
    ],
    "type": "object"
  },
  "risk_flags": []
}

{
  "annotations": {
    "openWorldHint": false,
    "readOnlyHint": true
  },
  "capabilities": [
    "read"
  ],
  "input_schema": {
    "properties": {
      "project_id": {
        "description": "UUID of the project: call list_projects to find it.",
        "format": "uuid",
        "type": "string"
      }
    },
    "required": [
      "project_id"
    ],
    "type": "object"
  },
  "risk_flags": []
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false,
    "readOnlyHint": false
  },
  "capabilities": [
    "network"
  ],
  "input_schema": {
    "properties": {
      "project_id": {
        "description": "UUID of the project: call list_projects to find it.",
        "format": "uuid",
        "type": "string"
      },
      "url": {
        "description": "The address of the candidate, exactly as list_corroboration_candidates gives it.",
        "type": "string"
      }
    },
    "required": [
      "project_id",
      "url"
    ],
    "type": "object"
  },
  "risk_flags": [
    "arbitrary_network_egress",
    "freeform_input_surface"
  ]
}

{
  "annotations": {
    "openWorldHint": false,
    "readOnlyHint": true
  },
  "capabilities": [
    "read"
  ],
  "input_schema": {
    "properties": {
      "category": {
        "description": "Only the manual entries of this category (tool events carry no category and never match).",
        "enum": [
          "content",
          "technical",
          "translation",
          "canon",
          "press",
          "other"
        ],
        "type": "string"
      },
      "deleted": {
        "description": "Set to \"only\" for the entries taken out of the logbook (delete_logbook_entry), most recently taken out first, each with its deleted_at. It carries recorded entries only, so it goes without source and category. Omitted, the logbook is read.",
        "enum": [
          "only"
        ],
        "type": "string"
      },
      "project_id": {
        "description": "UUID of the project: call list_projects to find it.",
        "format": "uuid",
        "type": "string"
      },
      "source": {
        "description": "Only the items of this source: \"tool\" for suite events, \"manual\" for recorded entries. Omitted, both.",
        "enum": [
          "tool",
          "manual"
        ],
        "type": "string"
      }
    },
    "required": [
      "project_id"
    ],
    "type": "object"
  },
  "risk_flags": []
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": false,
    "openWorldHint": false,
    "readOnlyHint": false
  },
  "capabilities": [
    "write"
  ],
  "input_schema": {
    "properties": {
      "category": {
        "description": "What kind of action this is; it files the entry for filtering. \"other\" covers anything else.",
        "enum": [
          "content",
          "technical",
          "translation",
          "canon",
          "press",
          "other"
        ],
        "type": "string"
      },
      "label": {
        "description": "Short wording of the action, e.g. \"Site translated into Spanish\": it is what the annotation shows next to the citation curves.",
        "type": "string"
      },
      "notes": {
        "description": "Free notes: context, links, details of the action.",
        "type": "string"
      },
      "occurred_at": {
        "description": "When the action HAPPENED, ISO 8601 date or datetime, read as UTC without an offset. Distinct from the recording time: when the user says \"yesterday\" or \"last week\", compute and pass that date. Omitted on creation, now is used.",
        "type": "string"
      },
      "project_id": {
        "description": "UUID of the project: call list_projects to find it.",
        "format": "uuid",
        "type": "string"
      }
    },
    "required": [
      "project_id",
      "category",
      "label"
    ],
    "type": "object"
  },
  "risk_flags": []
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false,
    "readOnlyHint": false
  },
  "capabilities": [
    "write"
  ],
  "input_schema": {
    "properties": {
      "category": {
        "description": "What kind of action this is; it files the entry for filtering. \"other\" covers anything else.",
        "enum": [
          "content",
          "technical",
          "translation",
          "canon",
          "press",
          "other"
        ],
        "type": "string"
      },
      "entry_id": {
        "description": "The UUID of the logbook entry: call get_logbook to find it (only manual entries carry an id).",
        "format": "uuid",
        "type": "string"
      },
      "label": {
        "description": "Short wording of the action, e.g. \"Site translated into Spanish\": it is what the annotation shows next to the citation curves.",
        "type": "string"
      },
      "notes": {
        "description": "Free notes: context, links, details of the action.",
        "type": "string"
      },
      "occurred_at": {
        "description": "When the action HAPPENED, ISO 8601 date or datetime, read as UTC without an offset. Distinct from the recording time: when the user says \"yesterday\" or \"last week\", compute and pass that date. Omitted on creation, now is used.",
        "type": "string"
      }
    },
    "required": [
      "entry_id"
    ],
    "type": "object"
  },
  "risk_flags": []
}

{
  "annotations": {
    "destructiveHint": true,
    "idempotentHint": true,
    "openWorldHint": false,
    "readOnlyHint": false
  },
  "capabilities": [
    "write",
    "delete"
  ],
  "input_schema": {
    "properties": {
      "entry_id": {
        "description": "The UUID of the logbook entry: call get_logbook to find it (only manual entries carry an id).",
        "format": "uuid",
        "type": "string"
      }
    },
    "required": [
      "entry_id"
    ],
    "type": "object"
  },
  "risk_flags": [
    "destructive_operation"
  ]
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false,
    "readOnlyHint": false
  },
  "capabilities": [
    "undetermined"
  ],
  "input_schema": {
    "properties": {
      "entry_id": {
        "description": "The UUID of the logbook entry: call get_logbook to find it (only manual entries carry an id).",
        "format": "uuid",
        "type": "string"
      }
    },
    "required": [
      "entry_id"
    ],
    "type": "object"
  },
  "risk_flags": []
}

{
  "annotations": {
    "openWorldHint": false,
    "readOnlyHint": true
  },
  "capabilities": [
    "read"
  ],
  "input_schema": {
    "properties": {
      "project_id": {
        "description": "Only the file of this project: the UUID of a project of the account (call list_projects). Omitted, the file covers every active project.",
        "format": "uuid",
        "type": "string"
      },
      "status": {
        "description": "Which quests to list: \"open\" (the file, default), \"done\" or \"dismissed\" (the closed history).",
        "enum": [
          "open",
          "done",
          "dismissed"
        ],
        "type": "string"
      }
    },
    "type": "object"
  },
  "risk_flags": []
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": false,
    "openWorldHint": false,
    "readOnlyHint": false
  },
  "capabilities": [
    "write"
  ],
  "input_schema": {
    "properties": {
      "notes": {
        "description": "Free notes: context, links, what done looks like.",
        "type": "string"
      },
      "project_id": {
        "description": "UUID of the project whose file takes the quest: call list_projects to find it.",
        "format": "uuid",
        "type": "string"
      },
      "title": {
        "description": "Short wording of the move, e.g. \"Get our MCP server listed on the AI tool directories\": it is what the file shows.",
        "type": "string"
      }
    },
    "required": [
      "project_id",
      "title"
    ],
    "type": "object"
  },
  "risk_flags": []
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false,
    "readOnlyHint": false
  },
  "capabilities": [
    "write"
  ],
  "input_schema": {
    "properties": {
      "notes": {
        "description": "Free notes: context, links, what done looks like.",
        "type": "string"
      },
      "quest_id": {
        "description": "The UUID of the quest: call list_quests to find it.",
        "format": "uuid",
        "type": "string"
      },
      "title": {
        "description": "Short wording of the move, e.g. \"Get our MCP server listed on the AI tool directories\": it is what the file shows.",
        "type": "string"
      }
    },
    "required": [
      "quest_id"
    ],
    "type": "object"
  },
  "risk_flags": []
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false,
    "readOnlyHint": false
  },
  "capabilities": [
    "undetermined"
  ],
  "input_schema": {
    "properties": {
      "quest_id": {
        "description": "The UUID of the quest: call list_quests to find it.",
        "format": "uuid",
        "type": "string"
      }
    },
    "required": [
      "quest_id"
    ],
    "type": "object"
  },
  "risk_flags": []
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false,
    "readOnlyHint": false
  },
  "capabilities": [
    "undetermined"
  ],
  "input_schema": {
    "properties": {
      "quest_id": {
        "description": "The UUID of the quest: call list_quests to find it.",
        "format": "uuid",
        "type": "string"
      }
    },
    "required": [
      "quest_id"
    ],
    "type": "object"
  },
  "risk_flags": []
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false,
    "readOnlyHint": false
  },
  "capabilities": [
    "write"
  ],
  "input_schema": {
    "properties": {
      "quest_id": {
        "description": "The UUID of the quest: call list_quests to find it.",
        "format": "uuid",
        "type": "string"
      }
    },
    "required": [
      "quest_id"
    ],
    "type": "object"
  },
  "risk_flags": []
}

{
  "annotations": {
    "openWorldHint": false,
    "readOnlyHint": true
  },
  "capabilities": [
    "read"
  ],
  "input_schema": {
    "properties": {
      "analyst": {
        "description": "Only the rows of this analyst. The custom_prompt analyst yields a text note per response, so the score series is built from the three scored lenses listed here.",
        "enum": [
          "keyword_presence",
          "share_of_voice",
          "sentiment"
        ],
        "type": "string"
      },
      "engine": {
        "description": "Only the rows of this engine.",
        "enum": [
          "chatgpt",
          "claude",
          "gemini",
          "perplexity",
          "mistral",
          "grok"
        ],
        "type": "string"
      },
      "tracker_id": {
        "description": "The UUID of the tracker: call list_trackers to find it.",
        "format": "uuid",
        "type": "string"
      }
    },
    "required": [
      "tracker_id"
    ],
    "type": "object"
  },
  "risk_flags": []
}

{
  "annotations": {
    "openWorldHint": false,
    "readOnlyHint": true
  },
  "capabilities": [
    "read"
  ],
  "input_schema": {
    "properties": {
      "engine": {
        "description": "The engine whose answers are read.",
        "enum": [
          "chatgpt",
          "claude",
          "gemini",
          "perplexity",
          "mistral",
          "grok"
        ],
        "type": "string"
      },
      "include_raw": {
        "description": "Add the full engine payload to every answer.",
        "type": "boolean"
      },
      "page": {
        "description": "Page number, 1 by default.",
        "minimum": 1,
        "type": "integer"
      },
      "per_page": {
        "description": "Answers per page, 25 by default, 100 at most.",
        "maximum": 100,
        "minimum": 1,
        "type": "integer"
      },
      "q": {
        "description": "Full-text filter on the answer text.",
        "type": "string"
      },
      "question": {
        "description": "Exact text of one tracked question.",
        "type": "string"
      },
      "survey": {
        "description": "Only the answers of this survey.",
        "format": "uuid",
        "type": "string"
      },
      "tone": {
        "description": "Only the answers where the sentiment analyst judged a keyword mention with this tone. Reads the negative answers of a week in one call, when the tracker carries the sentiment analyst that sets the tone.",
        "enum": [
          "positive",
          "neutral",
          "negative"
        ],
        "type": "string"
      },
      "tracker_id": {
        "description": "The UUID of the tracker: call list_trackers to find it.",
        "format": "uuid",
        "type": "string"
      }
    },
    "required": [
      "tracker_id",
      "engine"
    ],
    "type": "object"
  },
  "risk_flags": []
}

{
  "annotations": {
    "openWorldHint": false,
    "readOnlyHint": true
  },
  "capabilities": [
    "read"
  ],
  "input_schema": {
    "properties": {
      "tracker_id": {
        "description": "The UUID of the tracker: call list_trackers to find it.",
        "format": "uuid",
        "type": "string"
      }
    },
    "required": [
      "tracker_id"
    ],
    "type": "object"
  },
  "risk_flags": []
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": false,
    "openWorldHint": false,
    "readOnlyHint": false
  },
  "capabilities": [
    "write",
    "network"
  ],
  "input_schema": {
    "properties": {
      "domain": {
        "description": "One domain to act on, exactly as listed by list_keyword_discoveries. Send this OR domains, never both.",
        "type": "string"
      },
      "domains": {
        "description": "Several domains to act on in one call, each exactly as listed by list_keyword_discoveries. Send this OR domain, never both. ALL-OR-NOTHING: one invalid domain refuses the whole batch, so you never have to guess which half took.",
        "items": {
          "type": "string"
        },
        "type": "array"
      },
      "tracker_id": {
        "description": "The UUID of the tracker: call list_trackers to find it.",
        "format": "uuid",
        "type": "string"
      }
    },
    "required": [
      "tracker_id"
    ],
    "type": "object"
  },
  "risk_flags": [
    "arbitrary_network_egress",
    "freeform_input_surface"
  ]
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false,
    "readOnlyHint": false
  },
  "capabilities": [
    "write",
    "network"
  ],
  "input_schema": {
    "properties": {
      "domain": {
        "description": "One domain to act on, exactly as listed by list_keyword_discoveries. Send this OR domains, never both.",
        "type": "string"
      },
      "domains": {
        "description": "Several domains to act on in one call, each exactly as listed by list_keyword_discoveries. Send this OR domain, never both. ALL-OR-NOTHING: one invalid domain refuses the whole batch, so you never have to guess which half took.",
        "items": {
          "type": "string"
        },
        "type": "array"
      },
      "tracker_id": {
        "description": "The UUID of the tracker: call list_trackers to find it.",
        "format": "uuid",
        "type": "string"
      }
    },
    "required": [
      "tracker_id"
    ],
    "type": "object"
  },
  "risk_flags": [
    "arbitrary_network_egress",
    "freeform_input_surface"
  ]
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false,
    "readOnlyHint": false
  },
  "capabilities": [
    "write",
    "network"
  ],
  "input_schema": {
    "properties": {
      "domain": {
        "description": "One domain to act on, exactly as listed by list_keyword_discoveries. Send this OR domains, never both.",
        "type": "string"
      },
      "domains": {
        "description": "Several domains to act on in one call, each exactly as listed by list_keyword_discoveries. Send this OR domain, never both. ALL-OR-NOTHING: one invalid domain refuses the whole batch, so you never have to guess which half took.",
        "items": {
          "type": "string"
        },
        "type": "array"
      },
      "tracker_id": {
        "description": "The UUID of the tracker: call list_trackers to find it.",
        "format": "uuid",
        "type": "string"
      }
    },
    "required": [
      "tracker_id"
    ],
    "type": "object"
  },
  "risk_flags": [
    "arbitrary_network_egress",
    "freeform_input_surface"
  ]
}

{
  "annotations": {
    "openWorldHint": false,
    "readOnlyHint": true
  },
  "capabilities": [
    "read"
  ],
  "input_schema": {
    "properties": {
      "project_id": {
        "description": "Only the scans of this project: the UUID of a project of the account (call list_projects). Omitted, every project.",
        "format": "uuid",
        "type": "string"
      }
    },
    "type": "object"
  },
  "risk_flags": []
}

{
  "annotations": {
    "openWorldHint": false,
    "readOnlyHint": true
  },
  "capabilities": [
    "read"
  ],
  "input_schema": {
    "properties": {
      "competitor_scan_id": {
        "description": "The UUID of the competitor scan: call list_competitor_scans to find it.",
        "format": "uuid",
        "type": "string"
      }
    },
    "required": [
      "competitor_scan_id"
    ],
    "type": "object"
  },
  "risk_flags": []
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": false,
    "openWorldHint": false,
    "readOnlyHint": false
  },
  "capabilities": [
    "write"
  ],
  "input_schema": {
    "properties": {
      "category": {
        "description": "What qualifies each company in the questions, for example \"welding equipment manufacturer\".",
        "type": "string"
      },
      "country": {
        "description": "The market the questions name, as an ISO 3166-1 alpha-2 code (\"US\"). Omitted, the questions name no country.",
        "type": "string"
      },
      "engine": {
        "description": "The engine asked, ChatGPT by default. One per scan.",
        "enum": [
          "chatgpt",
          "claude",
          "gemini",
          "perplexity",
          "mistral",
          "grok"
        ],
        "type": "string"
      },
      "language": {
        "description": "The language the questions are asked in, for example \"en\". Omitted, the canonical language of the project.",
        "type": "string"
      },
      "project_id": {
        "description": "UUID of the project the scan belongs to: call list_projects to find it. Its brand is the one the list answers \"you are not there\" about.",
        "format": "uuid",
        "type": "string"
      },
      "subjects": {
        "description": "The basket: 3 to 5 companies of the same market.",
        "items": {
          "properties": {
            "name": {
              "description": "The company as the market names it, for example \"Lincoln Electric\".",
              "type": "string"
            },
            "website": {
              "description": "Its site, for example \"lincolnelectric.com\". Required: it is what identifies the company exactly.",
              "type": "string"
            }
          },
          "required": [
            "name",
            "website"
          ],
          "type": "object"
        },
        "maxItems": 5,
        "minItems": 3,
        "type": "array"
      },
      "title": {
        "description": "A name for the scan. Omitted, the category serves.",
        "type": "string"
      },
      "usage": {
        "description": "What buyers use it for, for example \"hobby welding\". Omitted, the category serves.",
        "type": "string"
      }
    },
    "required": [
      "project_id",
      "subjects",
      "category"
    ],
    "type": "object"
  },
  "risk_flags": []
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false,
    "readOnlyHint": false
  },
  "capabilities": [
    "undetermined"
  ],
  "input_schema": {
    "properties": {
      "competitor_scan_id": {
        "description": "The UUID of the competitor scan: call list_competitor_scans to find it.",
        "format": "uuid",
        "type": "string"
      }
    },
    "required": [
      "competitor_scan_id"
    ],
    "type": "object"
  },
  "risk_flags": []
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false,
    "readOnlyHint": false
  },
  "capabilities": [
    "write"
  ],
  "input_schema": {
    "properties": {
      "competitor_scan_id": {
        "description": "The UUID of the competitor scan: call list_competitor_scans to find it.",
        "format": "uuid",
        "type": "string"
      },
      "rescan_cadence": {
        "description": "How often the scan runs again: \"monthly\", or null to stop it.",
        "enum": [
          "monthly",
          null
        ],
        "type": [
          "string",
          "null"
        ]
      }
    },
    "required": [
      "competitor_scan_id"
    ],
    "type": "object"
  },
  "risk_flags": []
}

{
  "annotations": {
    "openWorldHint": false,
    "readOnlyHint": true
  },
  "capabilities": [
    "read",
    "network"
  ],
  "input_schema": {
    "properties": {
      "domain": {
        "description": "Keep only the domains containing this text, e.g. \"wikipedia\" or \".fr\".",
        "type": "string"
      },
      "engine": {
        "description": "Keep only the sources this engine has cited at least once.",
        "enum": [
          "chatgpt",
          "claude",
          "gemini",
          "perplexity",
          "mistral",
          "grok"
        ],
        "type": "string"
      },
      "page": {
        "description": "Page number, from 1.",
        "minimum": 1,
        "type": "integer"
      },
      "per_page": {
        "description": "Entries per page, 25 by default, 100 at most.",
        "maximum": 100,
        "minimum": 1,
        "type": "integer"
      },
      "project_id": {
        "description": "Only the sources surfaced by the trackers of this project: the UUID of a project of the account (call list_projects), or \"default\" for the trackers without a project. Use it to read the map of one brand when the account holds several. Omitted, the map covers every tracker of the account, which is what shows a source weighing on two of its markets at once. The AI Authority scale does not move with it: it stays computed across the whole map, so the figures of two projects compare.",
        "type": "string"
      },
      "sort": {
        "description": "Order of the page: \"aa_chatgpt\", \"aa_claude\", \"aa_gemini\", \"aa_perplexity\", \"aa_mistral\" or \"aa_grok\" for the ranking of one AI, which also keeps only the sources that AI cites; \"detections\" ranks across all AIs at once, \"engines\" by number of distinct engines, \"freshness\" by most recent detection, \"domain\" alphabetically. Defaults to \"detections\".",
        "enum": [
          "detections",
          "engines",
          "freshness",
          "domain",
          "aa_chatgpt",
          "aa_claude",
          "aa_gemini",
          "aa_perplexity",
          "aa_mistral",
          "aa_grok"
        ],
        "type": "string"
      }
    },
    "type": "object"
  },
  "risk_flags": [
    "arbitrary_network_egress",
    "freeform_input_surface"
  ]
}

{
  "annotations": {
    "openWorldHint": false,
    "readOnlyHint": true
  },
  "capabilities": [
    "read"
  ],
  "input_schema": {
    "properties": {
      "source_id": {
        "description": "The UUID of the source: call list_sources to find it.",
        "format": "uuid",
        "type": "string"
      }
    },
    "required": [
      "source_id"
    ],
    "type": "object"
  },
  "risk_flags": []
}

{
  "annotations": {
    "openWorldHint": false,
    "readOnlyHint": true
  },
  "capabilities": [
    "read"
  ],
  "input_schema": {
    "properties": {},
    "type": "object"
  },
  "risk_flags": []
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false,
    "readOnlyHint": false
  },
  "capabilities": [
    "write"
  ],
  "input_schema": {
    "properties": {
      "billing_address": {
        "description": "Postal address of the account, one string per line, like [\"12 Example Street\", \"75001 Paris\"]. The list replaces the previous address; [] or null clears it. Three lines at most, so the address block of an invoice stays readable.",
        "items": {
          "type": "string"
        },
        "maxItems": 3,
        "type": "array"
      },
      "billing_country": {
        "description": "Billing country, as an ISO 3166-1 alpha-2 code: \"FR\", \"US\", \"BR\". It decides the tax treatment of the next invoices, so it is the country of the entity being billed, not where the user happens to be.",
        "type": "string"
      },
      "intra_eu_vat_number": {
        "description": "Intra-EU VAT number, for an account billed in an EU member state: the two-letter country code followed by the national number, like \"FR12345678901\". It goes on the invoices of the account.",
        "type": "string"
      },
      "language": {
        "description": "The language we write to this account in: emails, and the hosted payment page of a top-up.",
        "enum": [
          "en",
          "fr",
          "es",
          "de",
          "it",
          "pt"
        ],
        "type": "string"
      },
      "name": {
        "description": "Legal name of the account, the one printed on its invoices.",
        "type": "string"
      },
      "timezone": {
        "description": "The time zone the hours of the account are shown in, as an IANA identifier: \"Europe/Paris\", \"America/New_York\", \"UTC\".",
        "type": "string"
      }
    },
    "type": "object"
  },
  "risk_flags": []
}

{
  "annotations": {
    "openWorldHint": false,
    "readOnlyHint": true
  },
  "capabilities": [
    "read",
    "financial"
  ],
  "input_schema": {
    "properties": {},
    "type": "object"
  },
  "risk_flags": []
}

{
  "annotations": {
    "openWorldHint": false,
    "readOnlyHint": true
  },
  "capabilities": [
    "read"
  ],
  "input_schema": {
    "properties": {
      "month": {
        "description": "A single month, YYYY-MM. Omitted: every month the account has entries for.",
        "pattern": "^\\d{4}-\\d{2}$",
        "type": "string"
      },
      "page": {
        "minimum": 1,
        "type": "integer"
      },
      "per_page": {
        "maximum": 100,
        "minimum": 1,
        "type": "integer"
      },
      "type": {
        "description": "Which entries to return: all (default), in (top-ups and adjustments), out (spend).",
        "enum": [
          "all",
          "in",
          "out"
        ],
        "type": "string"
      }
    },
    "type": "object"
  },
  "risk_flags": []
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": false,
    "openWorldHint": false,
    "readOnlyHint": false
  },
  "capabilities": [
    "write",
    "financial"
  ],
  "input_schema": {
    "properties": {
      "amount": {
        "description": "Credits to buy, in MAJOR units of the wallet currency: what a person says. 50 means 50.00, and 12.5 means 12.50. Use this one when the user names the amount, exactly as they said it. Minimum 10.00.",
        "exclusiveMinimum": 0,
        "type": "number"
      },
      "amount_minor": {
        "description": "Credits to buy, in MINOR units of the wallet currency: 5000 means 50.00. Use this one when you compute the amount from the cost grid, which is in minor units too. Minimum 1000.",
        "exclusiveMinimum": 0,
        "type": "integer"
      }
    },
    "type": "object"
  },
  "risk_flags": [
    "financial_transaction"
  ]
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": false,
    "openWorldHint": false,
    "readOnlyHint": false
  },
  "capabilities": [
    "write"
  ],
  "input_schema": {
    "properties": {
      "kind": {
        "description": "What this message is: sorts it on arrival.",
        "enum": [
          "problem",
          "suggestion",
          "question"
        ],
        "type": "string"
      },
      "message": {
        "description": "What you want to tell the support team, in the words of the user when they dictated it. Include what you tried and what happened.",
        "type": "string"
      },
      "subject": {
        "description": "Title of the thread. Derived from the message when omitted; ignored when replying.",
        "type": "string"
      },
      "thread_id": {
        "description": "Reply to this thread instead of opening a new one: call list_support_threads to find it.",
        "format": "uuid",
        "type": "string"
      }
    },
    "required": [
      "message"
    ],
    "type": "object"
  },
  "risk_flags": []
}

{
  "annotations": {
    "openWorldHint": false,
    "readOnlyHint": true
  },
  "capabilities": [
    "read"
  ],
  "input_schema": {
    "properties": {},
    "type": "object"
  },
  "risk_flags": []
}

{
  "annotations": {
    "openWorldHint": false,
    "readOnlyHint": true
  },
  "capabilities": [
    "read"
  ],
  "input_schema": {
    "properties": {
      "thread_id": {
        "description": "The UUID of the support thread: call list_support_threads to find it.",
        "format": "uuid",
        "type": "string"
      }
    },
    "required": [
      "thread_id"
    ],
    "type": "object"
  },
  "risk_flags": []
}

• For each high-risk tool (delete, exec, or network-egress capable), add a `confirm`/`dry_run` parameter or a two-step confirmation flow.
• Document the safeguard in the tool's description so clients and agents know confirmation is required before execution.
• Revalidate and confirm `action_safety_probe` reports the safeguard as detected.

• Return `Mcp-Session-Id` and `Mcp-Protocol-Version` headers consistently on streamable HTTP responses.
• Honor `DELETE` session teardown and return `404` when a deleted session is reused.
• Reject invalid protocol-version headers with `400 Bad Request`.

• Avoid removing tools or adding new required arguments to existing tools without a major version bump.
• Avoid breaking changes to `outputSchema` for tools already published to connector directories.
• This check reads `no_historical_snapshot` on a server's first validation run -- that is expected, not itself a defect, and resolves after a second run.

• Publish `/.well-known/mcp/server-card.json`.
• Include homepage, repository, support, tools, prompts/resources, and auth metadata.
• Revalidate the server after publishing the card.

• Review the tool snapshot diff for adds, removals, required-arg changes, and output-schema drift.
• Publish a changelog before managed connector clients refresh their frozen tool snapshots.
• Revalidate after the changelog and connector metadata are in sync.

• Update the server's advertised protocol version to a current MCP revision (2025-06-18 or later).
• Return the negotiated version consistently in both the `initialize` response and the `MCP-Protocol-Version` header.
• Revalidate and confirm `protocol_version_probe` reports `ok`.

• Review the blockers and failed criteria recorded by connector_publishability_probe.
• Correct the identified transport, authentication, server-card, or tool-stability gaps.
• Revalidate and require the probe to report no blockers before publishing the connector.

• Serve `/.well-known/openid-configuration` with `issuer`, `jwks_uri`, `authorization_endpoint`, and `token_endpoint`.
• List supported grant types in `grant_types_supported` and scopes in `scopes_supported`.
• Revalidate and confirm the `openid_configuration` check returns `ok`.

• Avoid changing tool names, required arguments, or output schemas between deploys unless the change is intentional.
• Publish a changelog entry when the tool surface changes so cached or frozen client snapshots can be reconciled.
• This check compares against the previous run, so it needs a second validation before it can report a stable baseline.

• Only advertise prompts that are actually accessible.
• Add prompt descriptions and argument docs.
• Run a live `prompts/list` check after any prompt changes.

• Only advertise resources with stable URIs and read semantics.
• Add MIME/type hints where possible.
• Run a live `resources/list` and `resources/read` check after updates.

• Persist session state keyed by `Mcp-Session-Id` so a client can reconnect after a dropped connection.
• Honor `Last-Event-ID` on GET reconnects to replay missed SSE events instead of erroring.
• Revalidate and confirm `session_resume_probe` no longer returns `warning`.

• Add the capabilities you actually support (`roots`, `sampling`, `elicitation`) to the `capabilities` object returned from `initialize`.
• Only advertise a capability once the corresponding request/response flow is implemented end to end.
• Revalidate and confirm `advanced_capabilities_probe` reflects the updated capability set.

• Locate or create the canonical entry in the official MCP registry.
• Publish the live MCP endpoint and reconcile its repository and homepage metadata.
• Revalidate and confirm official_registry_probe recognizes the reconciled entry.

• Compare the initialize result's instructions field with the current tools/list names.
• Rename the explicit reference or restore the missing tool.
• Revalidate and confirm instruction_tool_reference_probe reports ok.