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, written in en, fr, es, de, it, pt, ar, bg, cs, da, el, fi, he, hi, hu, id, ja, ko, ms, nl, no, pl, ro, ru, sk, sv, th, tr, uk, vi, zh, zh-hant. Omitted, the canonical language of the project. For another language, write to us with contact_support and we add it.",
        "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"
      },
      "templates": {
        "description": "Which questions to ask about each company, the four of them by default: `about_reputation` what is said about it, `about_price` whether it is worth its price, `about_customers` which companies use it and what they report, `compared_alternatives` what it is compared to. A sent list REPLACES that default, and the amount follows it: three companies and two templates make six questions.",
        "items": {
          "enum": [
            "about_reputation",
            "about_price",
            "about_customers",
            "compared_alternatives"
          ],
          "type": "string"
        },
        "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"
      },
      "questions": {
        "description": "The questions to KEEP, in the order to ask them. A sent list REPLACES the questions of the scan: one left out is removed. Draft only.",
        "items": {
          "properties": {
            "id": {
              "description": "UUID of one of the questions of this scan, as get_competitor_scan gives it.",
              "format": "uuid",
              "type": "string"
            },
            "text": {
              "description": "The wording to ask. Omitted, the question keeps the one it has.",
              "type": "string"
            }
          },
          "required": [
            "id"
          ],
          "type": "object"
        },
        "type": "array"
      },
      "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`.

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

• 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`.

• 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.