{"schema_version":"verify.report.v1","generated_at":"2026-08-15T18:22:58.758439+00:00","snapshot_id":"trustsnap_3bdde9009ffcd96e","server":{"namespace":"Epovest","name":"mcp-server","title":"Epovest","description":"Make AIs recommend your business. Measures how AI assistants answer the questions your market asks, which sources they cite, and gives the levers to shape those answers. 43 tools on a hosted Streamable HTTP endpoint at https://mcp.epovest.com/mcp","homepage_url":"https://glama.ai/mcp/servers/df7w4wyfi0","docs_url":null,"icon_url":null,"support_url":"https://github.com/Epovest/mcp-server","remote_url":"https://mcp.epovest.com/mcp","server_card_url":null,"latest_version":null,"current_status":"healthy","current_score":69.27,"transport_type":"streamable-http","has_oauth":true,"has_dcr":true,"has_prompts":false,"tool_count":66,"current_validation_schema_version":"8058defc70ca932c","last_validated_at":"2026-08-15T16:05:07.926953+00:00","registry_source":"glama_registry","registry_identifier":"glama_registry:df7w4wyfi0","canonical_identifier":null,"current_score_components":{"auth_operability_score":4.0,"error_contract_score":1.0,"rate_limit_semantics_score":2.0,"schema_completeness_score":3.0,"backward_compatibility_score":4.0,"slo_health_score":3.0,"security_hygiene_score":4.0,"task_success_score":4.0,"trust_confidence_score":4.0,"abuse_noise_ratio_score":4.0,"prompt_contract_score":2.0,"resource_contract_score":2.0,"discovery_metadata_score":2.0,"registry_consistency_score":2.0,"installability_score":4.0,"session_semantics_score":4.0,"tool_surface_design_score":3.0,"result_shape_stability_score":3.0,"oauth_interop_score":4.0,"recovery_semantics_score":1.0,"maintenance_signal_score":3.0,"adoption_signal_score":2.0,"freshness_confidence_score":4.0,"transport_fidelity_score":4.0,"spec_recency_score":2.0,"session_resume_score":3.0,"step_up_auth_score":4.0,"transport_compliance_score":2.0,"utility_coverage_score":1.0,"advanced_capability_coverage_score":1.0,"connector_publishability_score":2.0,"tool_snapshot_churn_score":4.0,"connector_replay_score":4.0,"request_association_score":0.0,"interactive_flow_safety_score":3.0,"action_safety_score":2.0,"official_registry_presence_score":2.0,"safety_transparency_score":2.0,"tool_capability_clarity_score":4.0,"destructive_operation_safety_score":3.0,"egress_ssrf_resilience_score":2.0,"execution_sandbox_safety_score":4.0,"data_exfiltration_resilience_score":3.0,"least_privilege_scope_score":2.0,"secret_handling_hygiene_score":3.0,"dependency_supply_chain_signal_score":0.0,"input_sanitization_safety_score":3.0,"tool_namespace_clarity_score":4.0},"capability_taxonomy":[],"machine_summary":{},"taxonomy_tags":[],"score_decomposition":[],"validation_diff":null,"tool_snapshot_diff":null,"connector_replay":{},"request_association":{},"production_readiness":{"code":"safe_for_evaluation","label":"Safe for evaluation","reason":"The server is suitable for evaluation, but remaining gaps should be resolved before broad production use.","badge":"score-medium","critical_alerts":0,"high_or_critical_alerts":0,"degraded_by_active_alerts":false},"recommended_for":[],"history_summary":{},"validation_timeline":[],"evidence_confidence":{"score":100.0,"label":"high","reason":"Based on 20 recent validations, 18 captured checks, and validation age of 2.3 hours.","live_check_count":18,"validation_age_hours":2.3,"basis":{"evidence_bearing_validations":20,"affirmative_live_check_count":18,"validation_age_hours":2.3,"freshness_threshold_hours":24}},"incident_feed":[],"disputes":[],"remediations":[],"client_remediation_modes":[],"client_profiles":[],"client_readiness_verdicts":[],"publishability_policy_profiles":[],"compatibility_fixtures":[],"install_snippets":{},"aliases":[],"raw_evidence":{"checks":{"probe_noise_resilience":{"status":"ok","latency_ms":109.19,"details":{"url":"https://mcp.epovest.com/robots.txt","http_status":200,"headers":{"content-type":"text/plain","set-cookie":"__cf_bm=_rXoY0BwfpDpNA5fMRYD1528GSy6S6uu0Y8cArwiTBI-1786809904.5819798-1.0.1.1-I3f.65FJaQVSKYV5t3em9OQwbZY_6M4sWSsFoIbnkpmgvcOZX70gKHImQGeHMI5baBbHaOU8eLVcmSaM5YOaomJKQypkNU5.CT9ju_MZWfdZoQsd4DiN_eHf_G6J0wod; HttpOnly; SameSite=None; Secure; Path=/; Domain=mcp.epovest.com; Expires=Sat, 15 Aug 2026 16:35:04 GMT"},"validation_disallowed":false,"consent_error":null}},"server_card":{"status":"error","latency_ms":170.26,"details":{"url":"https://mcp.epovest.com/.well-known/mcp/server-card.json","error":"Client error '404 Not Found' for url 'https://mcp.epovest.com/.well-known/mcp/server-card.json'\nFor more information check: https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/404"}},"oauth_protected_resource":{"status":"ok","latency_ms":189.82,"details":{"url":"https://mcp.epovest.com/.well-known/oauth-protected-resource","payload":{"resource":"https://mcp.epovest.com","authorization_servers":["https://app.epovest.com"],"scopes_supported":["read","write"],"bearer_methods_supported":["header"],"resource_documentation":"https://epovest.com/docs/api.md"},"http_status":200,"headers":{"content-type":"application/json","strict-transport-security":"max-age=31536000; includeSubDomains"}}},"oauth_authorization_server":{"status":"ok","latency_ms":231.15,"details":{"url":"https://app.epovest.com/.well-known/oauth-authorization-server","payload":{"issuer":"https://app.epovest.com","authorization_endpoint":"https://app.epovest.com/oauth/authorize","token_endpoint":"https://app.epovest.com/oauth/token","registration_endpoint":"https://app.epovest.com/oauth/register","revocation_endpoint":"https://app.epovest.com/oauth/revoke","revocation_endpoint_auth_methods_supported":["none","client_secret_post"],"client_id_metadata_document_supported":true,"authorization_response_iss_parameter_supported":true,"scopes_supported":["read","write"],"response_types_supported":["code"],"grant_types_supported":["authorization_code","refresh_token"],"code_challenge_methods_supported":["S256"],"token_endpoint_auth_methods_supported":["none","client_secret_post"]},"http_status":200,"headers":{"content-type":"application/json","strict-transport-security":"max-age=31536000; includeSubDomains","set-cookie":"__cf_bm=S7IqrJ3UmZkCMvvkhWyGda7acHaUiQqQKwh5.42P5.c-1786809905.1171222-1.0.1.1-hk2NxFNNLKMU.axuLhkG.GnCUrPp5DcV7VANhM54fOhdC0pPv62mcA3xUEjNLColMuBiT9OlaNYwLA4fBM9HZ.e6_tuoZk5CPPm9fKwNLycr9cF5fWWu0JxAkuvWheyx; HttpOnly; SameSite=None; Secure; Path=/; Domain=app.epovest.com; Expires=Sat, 15 Aug 2026 16:35:05 GMT"}}},"openid_configuration":{"status":"error","latency_ms":213.35,"details":{"url":"https://app.epovest.com/.well-known/openid-configuration","error":"Client error '404 Not Found' for url 'https://app.epovest.com/.well-known/openid-configuration'\nFor more information check: https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/404"}},"initialize":{"status":"ok","latency_ms":320.63,"details":{"url":"https://mcp.epovest.com/mcp","payload":{"jsonrpc":"2.0","id":1,"result":{"protocolVersion":"2025-03-26","capabilities":{"tools":{"listChanged":false}},"serverInfo":{"name":"epovest","title":"Epovest","version":"1.0.0"},"instructions":"Epovest is an AI visibility platform: it measures how AI assistants answer the questions your market asks, how often each keyword is cited and from which sources, and gives the levers to shape those answers. The tools act on the trackers of the account that owns the API key. Typical flow: list_trackers, then get_results for the score series or get_responses for raw engine answers. create_tracker prepares a new tracker in draft and start_tracker launches its measurement against the prepaid credit balance; both need the write scope, like update_tracker, which edits an existing tracker (only the fields you send change). get_credits reads that balance, with the amounts reserved by surveys in progress; topup_credits prepares a top-up and returns the hosted payment link for the user, nothing is charged without them: pass the amount they named, or suggest one when they leave it to you. A failed tool call returns the JSON error envelope of the REST API v1: same codes, same meaning. When a tool refuses what should work, when something is missing, or when the user asks you to tell us something, write to us with contact_support: a human answers in the thread, which you read back with get_support_thread. Full reference: https://epovest.com/docs/api.md"}},"http_status":200,"headers":{"content-type":"application/json","strict-transport-security":"max-age=31536000; includeSubDomains"}}},"protocol_version_probe":{"status":"warning","latency_ms":null,"details":{"claimed_version":"2025-03-26","validator_protocol_version":"2025-03-26","latest_known_version":"2025-11-25","releases_behind":2,"lag_days":244}},"tools_list":{"status":"ok","latency_ms":348.17,"details":{"url":"https://mcp.epovest.com/mcp","payload":{"jsonrpc":"2.0","id":2,"result":{"tools":[{"name":"list_trackers","title":"List trackers","description":"List the trackers of the account, current versions: configuration, status, keywords, analysts, project and the recalculated cost per survey. Start here to find a tracker id. Filter by project with project_id. The ones still followed come first, then the ones filed away (archive_tracker), each with archived true and its archived_at.","inputSchema":{"type":"object","properties":{"project_id":{"type":"string","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."}}},"annotations":{"readOnlyHint":true,"openWorldHint":false}},{"name":"create_tracker","title":"Create a tracker","description":"Create a tracker in draft. It measures nothing yet: call start_tracker to launch it against the prepaid credit balance. Validation rules and messages are the same as the app configurator. Omitted, next_survey_at means the first survey runs at start_tracker.","inputSchema":{"type":"object","properties":{"title":{"type":"string","description":"Display name of the tracker."},"prompts":{"type":"array","items":{"type":"string"},"description":"The questions asked to the AI engines at every survey, phrased exactly as a customer would ask them."},"engines":{"type":"array","items":{"type":"string","enum":["chatgpt","claude","gemini","perplexity","mistral","grok"]},"description":"The AI engines surveyed."},"frequency":{"type":"string","enum":["monthly","weekly","daily"],"description":"How often a survey runs."},"resolution":{"type":"string","enum":["hd","full_hd","4k","8k"],"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."},"keywords":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"object","properties":{"keyword":{"type":"string"},"favorite":{"type":"boolean"}},"required":["keyword"]}]},"description":"Names to detect in the answers: your brand and the names you compare against. Flag yours as favorite."},"analysts":{"type":"array","items":{"type":"string","enum":["keyword_presence","share_of_voice","sentiment","custom_prompt"]},"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."},"custom_prompt":{"type":"string","description":"The instruction of the custom_prompt analyst. Required when that analyst is selected."},"discovery":{"type":"boolean","description":"Suggest new keywords spotted in the answers."},"notify_on_survey":{"type":"boolean","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."},"next_survey_at":{"type":"string","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."},"project_id":{"type":"string","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."}},"required":["title","prompts","engines","frequency","resolution"]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"update_tracker","title":"Update a tracker","description":"Update the configuration of a tracker: only the fields you send change. Keywords, analysts and the title apply in place. Changing the prompts, engines, frequency or resolution of a tracker that has measured creates a new version: the score series continues across versions, and the response carries the new tracker id (version_created says when). A sent list replaces the previous one entirely.","inputSchema":{"type":"object","properties":{"tracker_id":{"type":"string","format":"uuid","description":"The UUID of the tracker: call list_trackers to find it."},"title":{"type":"string","description":"Display name of the tracker."},"prompts":{"type":"array","items":{"type":"string"},"description":"The questions asked to the AI engines at every survey, phrased exactly as a customer would ask them."},"engines":{"type":"array","items":{"type":"string","enum":["chatgpt","claude","gemini","perplexity","mistral","grok"]},"description":"The AI engines surveyed."},"frequency":{"type":"string","enum":["monthly","weekly","daily"],"description":"How often a survey runs."},"resolution":{"type":"string","enum":["hd","full_hd","4k","8k"],"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."},"keywords":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"object","properties":{"keyword":{"type":"string"},"favorite":{"type":"boolean"}},"required":["keyword"]}]},"description":"Names to detect in the answers: your brand and the names you compare against. Flag yours as favorite."},"analysts":{"type":"array","items":{"type":"string","enum":["keyword_presence","share_of_voice","sentiment","custom_prompt"]},"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."},"custom_prompt":{"type":"string","description":"The instruction of the custom_prompt analyst. Required when that analyst is selected."},"discovery":{"type":"boolean","description":"Suggest new keywords spotted in the answers."},"notify_on_survey":{"type":"boolean","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."},"next_survey_at":{"type":"string","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."},"project_id":{"type":"string","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."}},"required":["tracker_id"]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"start_tracker","title":"Start a tracker","description":"Start or restart the measurement of a tracker against the prepaid credit balance. Refused with insufficient_credits when the balance does not cover one survey; that answer carries top_up_url, the page where the person adds credit, so give it to them. Starting an already active tracker changes nothing.","inputSchema":{"type":"object","properties":{"tracker_id":{"type":"string","format":"uuid","description":"The UUID of the tracker: call list_trackers to find it."}},"required":["tracker_id"]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"survey_now","title":"Survey a tracker now","description":"Run one survey of a measuring tracker right now, on top of its schedule. Its settings stay as they are: same anchor, same frequency, and the next scheduled survey keeps its date. It debits the prepaid credit balance like any survey, and the point joins the score series marked on_demand. The answer carries the survey id: read the results back with get_results, or the raw answers with get_responses. While one is still running, calling again answers that survey instead of starting a second one. Refused with insufficient_credits when the balance does not cover it, and that answer carries top_up_url, the page where the person adds credit, so give it to them. Refused with tracker_not_active when the tracker is not measuring yet: start_tracker first.","inputSchema":{"type":"object","properties":{"tracker_id":{"type":"string","format":"uuid","description":"The UUID of the tracker: call list_trackers to find it."}},"required":["tracker_id"]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"pause_tracker","title":"Pause a tracker","description":"Pause the measurement of an active tracker. The score series is kept; start_tracker resumes it.","inputSchema":{"type":"object","properties":{"tracker_id":{"type":"string","format":"uuid","description":"The UUID of the tracker: call list_trackers to find it."}},"required":["tracker_id"]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"archive_tracker","title":"File a tracker away","description":"File a finished tracker away: a campaign that ended, a brand that was sold, a trial that is over. It moves to the end of list_trackers with archived true, stops asking for anything, and its measurement pauses in the same call if it was still running, so the spending stops there. Bring it back with archived false: the tracker returns to the list as it was, and start_tracker restarts the measurement when the user asks for it. The sheet and the score series are kept and stay readable throughout (get_results answers as usual). Filing away an already filed tracker answers the same.","inputSchema":{"type":"object","properties":{"tracker_id":{"type":"string","format":"uuid","description":"The UUID of the tracker: call list_trackers to find it."},"archived":{"type":"boolean","description":"true files the tracker away and pauses its measurement, false brings it back. Omitted, it files it away."}},"required":["tracker_id"]},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false}},{"name":"list_projects","title":"List projects","description":"The projects of the account: the folders trackers are filed under (one project per tracker at most; pure organization, no effect on measurement or billing). Each carries its id, name, brand canon with its current version number (canon_version), archived flag and tracker count. The folders still in use come first, then the ones filed away (archive_project). Trackers without a project live under the virtual Default project.","inputSchema":{"type":"object","properties":{}},"annotations":{"readOnlyHint":true,"openWorldHint":false}},{"name":"create_project","title":"Create a project","description":"Create a project to file trackers under: one project per BRAND, never per language. It can carry the brand canon: the reference wording every publication reuses as is, written in ONE language, its canonical language (carried at creation, it is recorded as canon version 1). The canon is never translated: localized expressions on the pages are outputs, not a second canon. Nothing is filed by this call: pass the returned id as project_id when creating or updating a tracker. Refused with project_exists when a project with this name already exists, and the answer carries the existing project: reuse its id instead of duplicating.","inputSchema":{"type":"object","properties":{"name":{"type":"string","description":"Name of the project, as the user calls it (a client, a brand, a website...)."},"canon_one_liner":{"type":"string","description":"One-sentence signature of the brand."},"canon_short":{"type":"string","description":"THE one-sentence description third-party pages reuse as is."},"canon_long":{"type":"string","description":"The two-sentence version, when the surface allows it."},"canon_category":{"type":"string","description":"Category label for listings and structured data."},"canon_language":{"type":"string","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."},"canon_perks":{"type":"array","items":{"type":"string"},"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."},"canon_website":{"type":"string","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."},"canon_legal_name":{"type":"string","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."},"canon_address":{"type":"string","description":"Postal address, as written on a listing. Language-neutral: the same string everywhere, like the other facts."},"canon_phone":{"type":"string","description":"Phone number, international prefix included."},"canon_whatsapp":{"type":"string","description":"WhatsApp number, international prefix included."},"canon_email":{"type":"string","description":"Public email address of the brand."}},"required":["name"]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"rename_project","title":"Rename a project","description":"Correct the name of a project: the folder keeps its id, its canon, its trackers, its surfaces and its logbook, and the name shown is the only thing that changes. Names are unique per account: a name another project already goes by answers project_exists with that project, so read it back and settle another name with the user. Case, accents and spacing do not make two different names, which is why a project can always take back its own capitalisation. Sending the name it already carries answers the same, and a project filed away renames like any other. Use it for the name of the folder; the wording of the brand itself is the canon, and it moves with update_project_canon.","inputSchema":{"type":"object","properties":{"project_id":{"type":"string","format":"uuid","description":"UUID of the project: call list_projects to find it."},"name":{"type":"string","description":"The name the project takes, as the user calls it (a client, a brand, a website...)."}},"required":["project_id","name"]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_canon","title":"Read the canon of a project and its history","description":"The brand canon of a project and every revision it went through. canon is the CURRENT wording, under the same keys update_project_canon writes (one_liner, short, long, category, language, perks, website, legal_name, address, phone, whatsapp, email), and canon_version its number. history carries each version newest first, with its author, its date, and changes, the fields that version touched with their before and after values. Reach for it to RE-PROPAGATE a revision: get_logbook says a canon moved to a version and which keys it touched, this says what the old wording was, which is the string to find on a page and replace, and what the new one is. Values come back raw, so perks is the ordered list and language the short code. On a project whose canon is not posted yet, history is empty and canon_version is null.","inputSchema":{"type":"object","properties":{"project_id":{"type":"string","format":"uuid","description":"UUID of the project: call list_projects to find it."}},"required":["project_id"]},"annotations":{"readOnlyHint":true,"openWorldHint":false}},{"name":"update_project_canon","title":"Update the canon of a project","description":"Revise the brand canon of a project. Field by field: a provided field replaces the current wording (an empty string clears it), an omitted field is kept as is. Any actual change records the NEXT canon version (numbered, immutable; version_created true in the answer); sending identical wording records nothing. The canon lives in ONE language, its canonical language (canon_language): it is never translated, changing the language is a revision like any other. The canon is meant to be STABLE: revising it is a rare and deliberate move, and every surface that reuses the wording will need to be brought back in phase with the new version. Confirm with the user before revising.","inputSchema":{"type":"object","properties":{"project_id":{"type":"string","description":"UUID of the project: call list_projects to find it."},"canon_one_liner":{"type":"string","description":"One-sentence signature of the brand."},"canon_short":{"type":"string","description":"THE one-sentence description third-party pages reuse as is."},"canon_long":{"type":"string","description":"The two-sentence version, when the surface allows it."},"canon_category":{"type":"string","description":"Category label for listings and structured data."},"canon_language":{"type":"string","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."},"canon_perks":{"type":"array","items":{"type":"string"},"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."},"canon_website":{"type":"string","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."},"canon_legal_name":{"type":"string","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."},"canon_address":{"type":"string","description":"Postal address, as written on a listing. Language-neutral: the same string everywhere, like the other facts."},"canon_phone":{"type":"string","description":"Phone number, international prefix included."},"canon_whatsapp":{"type":"string","description":"WhatsApp number, international prefix included."},"canon_email":{"type":"string","description":"Public email address of the brand."}},"required":["project_id"]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_link_targets","title":"List the addresses of the brand a link can point to","description":"The addresses of the brand that a watched page can link to. Two lists come back. derived: what is already covered without anyone typing it, each row with its source, \"canon\" (the canonical website of the brand) or \"surface\" (a page of the surface registry: the site, the LinkedIn or X profile, a directory listing, an app store page). free: the addresses set on the project on top of those. Read it before setting anything: an address already derived does not need to be added, and the derived list is what the customer gets for free from work already done. A link towards any of these is what the reading pass reports on, with its rel tokens, its anchor, its destination and its place on the page.","inputSchema":{"type":"object","properties":{"project_id":{"type":"string","format":"uuid","description":"UUID of the project: call list_projects to find it."}},"required":["project_id"]},"annotations":{"readOnlyHint":true,"openWorldHint":false}},{"name":"set_link_targets","title":"Set the free addresses of the brand","description":"Set the addresses of the brand that are neither its canonical website nor a page of the surface registry: a satellite domain the customer does not want to keep aligned, a tracking link, a partner page. They are set ONCE for the project and serve every line of the corroboration registry, present and future, so there is nothing to set line by line. The list you send REPLACES the previous one, and the answer returns what the project now holds, derived addresses included: read it back to confirm. An empty list keeps only the derived ones. Call get_link_targets first, and confirm with the user before replacing.","inputSchema":{"type":"object","properties":{"project_id":{"type":"string","format":"uuid","description":"UUID of the project: call list_projects to find it."},"link_targets":{"type":"array","items":{"type":"string"},"description":"The FULL list of the free addresses, as absolute http(s) URLs. It replaces the previous one."}},"required":["project_id","link_targets"]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"archive_project","title":"File a project away","description":"File a project away once the folder has served its purpose: a client that left, a brand that was sold. It moves to the end of list_projects with archived true, and stops being offered when filing a tracker. Bring it back with archived false. Nothing is deleted and nothing cascades: the trackers filed under it keep their status, keep measuring and keep showing up in list_trackers, and the answer carries tracker_count, how many are still filed under it, so you can go on with archive_tracker on each one when that is what the user meant. Filing away an already filed project answers the same. Default is where trackers without a folder live: it has no id, so this tool always takes the UUID of a project of the account.","inputSchema":{"type":"object","properties":{"project_id":{"type":"string","format":"uuid","description":"UUID of the project: call list_projects to find it."},"archived":{"type":"boolean","description":"true files the project away, false brings it back. Omitted, it files it away."}},"required":["project_id"]},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false}},{"name":"list_surfaces","title":"List the surfaces of a project","description":"The surface registry of a project: the pages about the brand where the customer has the FINAL SAY (website, GitHub, LinkedIn, X, YouTube, Wikidata, directories, app stores...). The split with corroborations is control, never who wrote the page: a page the customer can change is a surface, a page where someone else has the final say is a corroboration (list_corroborations). Each surface carries its type, url, label, languages, notes, its checklist and a status DERIVED from the checklist CELLS that hold it: checklist.required lists exactly those, the canon items of the template plus every check the customer added of their own. checklist.kinds answers a different question, what PERISHES a tick: \"canon\" items restate the canon, so their verification perishes when the wording moves; \"presence\" ones, such as site_link, hold. A check of the customer holds the status whatever its kind, so read checklist.required and deduce nothing from checklist.kinds. checklist.custom lists those checks, each with its key, label, scope and restates_canon, and the ones taken out with deleted true, which restore_surface_check brings back; add_surface_check is how a new one is posed. Each cell is verified (dated, stamped with the canon version whose WORDING it restated: it stays fresh until the wording moves, and a revision that touches no wording, such as declaring the canonical language, perishes nothing) or set aside with its reason (the item does not apply on THIS surface). Three statuses, never a fourth: aligned when every required cell not set aside is verified at the current wording; needs_update when some verification is missing or stale; never_aligned when none exists. There is no state for a page the canon does not apply to, because setting aside the LAST canon cell is refused with not_a_surface, because a page that carries none of the canon is not a surface: turn it into a corroboration if someone else has the final say on it, or take it out of the registry. checklist.state keeps the flat view of verified items; checklist.progress counts done, total and dismissed, the set-aside cells out of the denominator but never hidden. Each surface also carries domain_authority, what the AIs grant the DOMAIN the page sits on, read from the Atlas: domain is the registrable domain that was measured, engines its AI Authority on each AI over the last 30 days, source_id its entry on the map (read it with get_source). The unit is the domain, so the figure says that PLACE is read, and list_sources reads the very same one. An engine absent from engines has not cited the domain lately, which is not a zero, and a source_id of null means the domain is not on the map of this account, which carries the sources the surveys of this account surfaced and grows as it measures more. Start here to find a surface id. Set deleted to \"only\" to read the trash of the registry instead of it.","inputSchema":{"type":"object","properties":{"project_id":{"type":"string","format":"uuid","description":"UUID of the project: call list_projects to find it."},"deleted":{"type":"string","enum":["only"],"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."},"sort":{"type":"string","enum":["registry","authority"],"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."}},"required":["project_id"]},"annotations":{"readOnlyHint":true,"openWorldHint":false}},{"name":"create_surface","title":"Register a surface","description":"Register a surface of a project: one page about the brand where the customer has the final say (their site, their profiles, their listings, wherever they can change the content). URL-FIRST: the url is the only thing needed, type and label are derived from it; pass them only to correct a derivation. It is born never_aligned: bring the page in phase with the canon, then record what it carries with tick_surface_checklist, cell by cell. The aligned status DERIVES from those verifications and is never declared: verifying the last canon cell aligns the surface on its own.","inputSchema":{"type":"object","properties":{"project_id":{"type":"string","format":"uuid","description":"UUID of the project: call list_projects to find it."},"type":{"type":"string","enum":["website","github","linkedin","x","youtube","wikidata","directory","app_store","other"],"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."},"url":{"type":"string","description":"Absolute http(s) address of the surface."},"label":{"type":"string","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)."},"languages":{"type":"array","items":{"type":"string"},"description":"Languages of the surface, as short codes like \"en\" or \"pt-br\". A sent list replaces the previous one."},"notes":{"type":"string","description":"Free registry notes: who owns the account, access, context."}},"required":["project_id","url"]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"update_surface","title":"Update a surface","description":"Update the registry sheet of a surface: only the fields you send change (a sent languages list replaces the previous one; an empty label or notes clears it). No journal line is ever written here: an alignment is earned with tick_surface_checklist, cell by cell. Languages ARE the columns of the checklist, so declaring the language of a single-language page renames its column and carries its verified cells along. When the change leaves no single destination (a language dropped from a page that keeps others, one column split into several), the columns that leave the model come back in dropped_checklist_columns with what they held; their cells stay stored, and declaring the language again brings them back. The status of the answer is derived from the cells that read NOW, so read it back rather than assuming it held.","inputSchema":{"type":"object","properties":{"surface_id":{"type":"string","format":"uuid","description":"The UUID of the surface: call list_surfaces to find it."},"type":{"type":"string","enum":["website","github","linkedin","x","youtube","wikidata","directory","app_store","other"],"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."},"url":{"type":"string","description":"Absolute http(s) address of the surface."},"label":{"type":"string","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)."},"languages":{"type":"array","items":{"type":"string"},"description":"Languages of the surface, as short codes like \"en\" or \"pt-br\". A sent list replaces the previous one."},"notes":{"type":"string","description":"Free registry notes: who owns the account, access, context."}},"required":["surface_id"]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"tick_surface_checklist","title":"Verify or set aside checklist cells of a surface","description":"Record what a surface actually carries, cell by cell, as many moves as you want in one call. The items are listed by list_surfaces as checklist.items: the template of the surface type (stable keys such as title_tag or llms_txt), then the checks the customer added of their own (add_surface_check), which tick here exactly like the rest, at their key. Most of them are yours to check (a title tag, JSON-LD, an llms.txt all read with a simple fetch). Three moves per cell. VERIFY (done true, or nothing): the item is constated on the page; an item of canon kind (checklist.kinds) is stamped with the current canon version and wording, so its verification stays fresh until the wording moves, and needs the canon set first. SET ASIDE (dismissed true plus a short reason): the item does not apply on THIS surface (an author bio, a field the platform does not offer); durable across canon revisions, reversible, never hidden from the counts. CLEAR (done false, or dismissed false): the cell returns to blank. A site-wide item (checklist.site_items: the llms.txt, one file at the root of the site, written in the canonical language of the project) is one cell for the whole site, without a language. Only the cells you send change; an unknown item or language, a set-aside without reason or a contradictory move refuses the whole batch and says what exists. The ALIGNED status derives from the cells listed in checklist.required, the canon items plus the checks of the customer: verifying the last one aligns the surface and dates it in the journal. The goal is a surface with no required cell left undecided: work every one of them to a verdict, verified when the page carries it or set aside with a reason when the item does not apply here. Leaving a cell untouched is not a neutral skip, it holds the surface in needs_update and hides whether the page was ever checked, so go through the whole checklist and not only the cells easy to confirm. And setting aside the LAST canon cell is refused, because a page that carries none of the canon is not a surface: turn it into a corroboration if someone else has the final say on it, or take it out of the registry.","inputSchema":{"type":"object","properties":{"surface_id":{"type":"string","format":"uuid","description":"The UUID of the surface: call list_surfaces to find it."},"ticks":{"type":"array","description":"The cell moves. Nothing else on the checklist changes.","items":{"type":"object","properties":{"item":{"type":"string","description":"The item, exactly as listed by list_surfaces in checklist.items for the type of this surface."},"language":{"type":"string","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."},"done":{"type":"boolean","description":"true verifies the cell, false clears it. Omitted (and no dismissed), it verifies."},"dismissed":{"type":"boolean","description":"true sets the cell aside (a \"reason\" is due), false brings it back to blank. Never combined with done."},"reason":{"type":"string","description":"Why the item does not apply on this surface, short: the exception must be readable without its author. Due when dismissed is true."}},"required":["item"]}}},"required":["surface_id","ticks"]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"add_surface_check","title":"Add a check of your own to the checklist of a surface","description":"Add a check of your own to the checklist of one surface: a requirement the person holds on THAT page, in their words. It becomes REQUIRED for the page to count as aligned, exactly like the canon items of the template, and it is ticked with tick_surface_checklist at the key returned here. Reach for it whenever the person states something a page must carry that is theirs to decide: the pricing block quotes the canon boilerplate, the OG image is the current one, the footer carries the legal name, the pinned post links to the launch page. restates_canon is the one judgement to make, and the question is simple: does the tick become FALSE when the wording of the canon changes? True for a check that restates the canon, and its verification then perishes with the wording, putting the page back in the queue; false, the default, for a check that constates anything else, and the tick then stands until someone clears it. Sending the same label again returns the check already there, and brings it back from the trash if it was in it, so a replay never duplicates. Up to 20 checks on a surface.","inputSchema":{"type":"object","properties":{"surface_id":{"type":"string","format":"uuid","description":"The UUID of the surface: call list_surfaces to find it."},"label":{"type":"string","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\")."},"restates_canon":{"type":"boolean","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."},"scope":{"type":"string","enum":["site","language"],"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."}},"required":["surface_id","label"]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"update_surface_check","title":"Correct a check of your own","description":"Correct a check of your own on a surface: its label, and whether it restates the canon. Only what you send changes. The key never moves, being the coordinate of the cells already recorded, so renaming a check keeps every tick it carries. Turning restates_canon on makes a tick recorded without a canon stamp perish, which is the honest reading: the page was never checked against a wording.","inputSchema":{"type":"object","properties":{"surface_id":{"type":"string","format":"uuid","description":"The UUID of the surface: call list_surfaces to find it."},"check":{"type":"string","description":"The key of the check of your own, exactly as listed by list_surfaces in checklist.custom (add_surface_check returns it too)."},"label":{"type":"string","description":"The new wording of the check, up to 120 characters."},"restates_canon":{"type":"boolean","description":"true when the check restates the WORDING of the canon, false when it constates something else."}},"required":["surface_id","check"]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"delete_surface_check","title":"Take a check of your own out of a checklist","description":"Take a check of your own out of the checklist of a surface: it leaves the list, stops holding the page short of aligned and stops accepting ticks. Use it when the requirement no longer applies to that page. Nothing is lost: the check and the cells it carries are kept, read back in checklist.custom with deleted true, and restore_surface_check brings both back, so a check taken out by mistake costs nothing. Taking out an already taken out check answers the same.","inputSchema":{"type":"object","properties":{"surface_id":{"type":"string","format":"uuid","description":"The UUID of the surface: call list_surfaces to find it."},"check":{"type":"string","description":"The key of the check of your own, exactly as listed by list_surfaces in checklist.custom (add_surface_check returns it too)."}},"required":["surface_id","check"]},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false}},{"name":"restore_surface_check","title":"Bring a check of your own back to a checklist","description":"Bring a check of your own back to the checklist of a surface, with the cells it had: it becomes work again, so the page needs it verified to count as aligned. The checks to bring back are listed by list_surfaces in checklist.custom, with deleted true. Restoring a check already in the checklist answers the same.","inputSchema":{"type":"object","properties":{"surface_id":{"type":"string","format":"uuid","description":"The UUID of the surface: call list_surfaces to find it."},"check":{"type":"string","description":"The key of the check of your own, exactly as listed by list_surfaces in checklist.custom (add_surface_check returns it too)."}},"required":["surface_id","check"]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"delete_surface","title":"Take a surface out of the registry","description":"Take a surface out of the registry: the page stops being followed, and the registry stops asking to bring it in phase with the canon. Use it for a page that is gone (account closed, listing removed) or for a line that had no place there. The sheet and the alignment journal are kept, and restore_surface brings the surface back with them, so a line taken out by mistake costs nothing. Taking out an already taken out surface answers the same.","inputSchema":{"type":"object","properties":{"surface_id":{"type":"string","format":"uuid","description":"The UUID of the surface: call list_surfaces to find it."}},"required":["surface_id"]},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false}},{"name":"restore_surface","title":"Bring a surface back to the registry","description":"Bring a surface back to the registry, with its sheet and its alignment journal as they were. Call list_surfaces with deleted set to \"only\" to find the surfaces to bring back. Restoring a surface already in the registry answers the same.","inputSchema":{"type":"object","properties":{"surface_id":{"type":"string","format":"uuid","description":"The UUID of the surface: call list_surfaces to find it."}},"required":["surface_id"]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"convert_surface_to_corroboration","title":"Move a surface to the corroboration registry","description":"Move the page to the corroboration registry: someone else has the final say on it (the customer lost, or never had, the hand on the content). Nothing is retyped: url, label and notes travel, the publication date stays unknown (set it with update_corroboration when known). The surface leaves its registry for the trash, alignment journal attached, and the reverse move exists (convert_corroboration_to_surface): nothing is lost, and replaying the move finds the same line instead of duplicating it. The own site of the brand is refused (own_domain): it stays a surface. It moves a line the customer declared: confirm with the user first.","inputSchema":{"type":"object","properties":{"surface_id":{"type":"string","format":"uuid","description":"The UUID of the surface: call list_surfaces to find it."}},"required":["surface_id"]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"list_corroborations","title":"List the corroborations of a project","description":"The corroborations recorded for a project: the pages about the brand where someone else has the FINAL SAY, each with its exact address, the source it sits on (domain), the publication date when known, and free notes. Live ones first, then the ones taken down (archived true). The twin registry of Surfaces, where the customer has the final say: the split is control, never who wrote the page or who paid for it. Asking such a source for a change stays a normal move; record the outcome in the logbook. What comes back is what the customer DECLARED: the registry is theirs to fill, and list_corroboration_candidates proposes pages the engines already showed the brand on.","inputSchema":{"type":"object","properties":{"project_id":{"type":"string","format":"uuid","description":"UUID of the project: call list_projects to find it."}},"required":["project_id"]},"annotations":{"readOnlyHint":true,"openWorldHint":false}},{"name":"create_corroboration","title":"Record a corroboration","description":"Record a page about the brand where someone else has the final say. URL-FIRST: the exact address of the page is the only thing needed, the source on the map and the display name are derived from it. It is a statement of fact: only record a page you have actually read, and confirm with the user. A page the customer controls (their own profile, their own listing) belongs to Surfaces instead: use create_surface. Three refusals answer with their own slug: unplaceable_url (the address has no registrable domain), own_domain (this is the own site of the brand, where they have the final say: use create_surface), duplicate (the page is already in the registry, 409).","inputSchema":{"type":"object","properties":{"project_id":{"type":"string","format":"uuid","description":"UUID of the project: call list_projects to find it."},"url":{"type":"string","description":"Absolute http(s) address of the EXACT page where the third party talks about the brand, never the home page of the site."},"label":{"type":"string","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."},"published_on":{"type":"string","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."},"notes":{"type":"string","description":"Free notes: the passage that mentions the brand, the contact, how the page came about."},"request_channel":{"type":"string","enum":["available","none","unknown"],"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."}},"required":["project_id","url"]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"update_corroboration","title":"Update a corroboration","description":"Update the sheet of a corroboration: only the fields you send change (an empty label goes back to the derived one, an empty notes or published_on clears it). Correcting the url ALWAYS recomputes the source: the two never drift apart. It also carries monitoring, the cadence at which the page is read again on its own, which is why watching a page needs no tool of its own. To say a page is gone, use archive_corroboration instead: editing never takes anything down.","inputSchema":{"type":"object","properties":{"corroboration_id":{"type":"string","format":"uuid","description":"The UUID of the corroboration: call list_corroborations to find it."},"url":{"type":"string","description":"Absolute http(s) address of the EXACT page where the third party talks about the brand, never the home page of the site."},"label":{"type":"string","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."},"published_on":{"type":"string","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."},"notes":{"type":"string","description":"Free notes: the passage that mentions the brand, the contact, how the page came about."},"request_channel":{"type":"string","enum":["available","none","unknown"],"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."},"monitoring":{"type":"string","enum":["off","daily","weekly","monthly"],"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."}},"required":["corroboration_id"]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"archive_corroboration","title":"Take a corroboration down, or put it back live","description":"Record that the page is no longer there (article unpublished, link dead), or put it back live with archived false. Nothing is deleted: the line stays, and so does the history, because \"they talked about us from March to July\" is information. A page taken down stops counting as a presence on that source. Only take down after actually re-reading the address and finding it gone.","inputSchema":{"type":"object","properties":{"corroboration_id":{"type":"string","format":"uuid","description":"The UUID of the corroboration: call list_corroborations to find it."},"archived":{"type":"boolean","description":"true takes the page down, false puts it back live. Omitted, it takes it down."}},"required":["corroboration_id"]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"verify_corroboration","title":"Check a corroboration against its page, now","description":"Read the page again and report what it says today. One pass returns two findings, dated, and included at no cost. On the MENTION: the passage around the brand is archived on the line (the sentence that names it, one before, one after), and the finding says unchanged, changed (the passage moved, worth re-reading), figures (the passage moved on NUMBERS only, such as a rank or a counter: a fact to read, and changed_at stays where it was) or gone (the page did not answer). When a change was found, excerpt_before carries the passage as it stood BEFORE changed_at: compare it with excerpt to state what moved, in words, without reading the whole page. On the LINK: every link of the page towards an address of the brand, derived from the canon website and from the surface registry of the project, with its rel tokens (nofollow, sponsored, ugc, or none), its target and title attributes, its anchor text, its exact destination with the resolved redirect chain and the HTTP code of that destination, whether it sits in the main content or outside it, and its dates; the finding says unchanged, changed (changes lists what moved: rel, anchor, target, placement, appeared), gone, or none, which means the page carries no such link and is a normal state. The reply also carries how the page reads (readability: \"html\" when it reads, \"blocked\" when an anti-bot stands in front of it, \"unreachable\" when it did not answer, \"no_page\" when the address answers with something that is not a page, \"unreadable\" when it answers HTML with no text in it, \"pending\" while no reading has completed yet), the number of outbound links of the page, and what the page declares about itself (noindex, page_nofollow, canonical_elsewhere). Read readability before deciding a move: an anti-bot is a fact of the world, while a page that did not answer is worth reading again. Everything here is a FACT: the third party has the final say, so nothing closes, nothing counts, and nothing is taken down on its own. Use it to decide a move, then record the outcome in the logbook.","inputSchema":{"type":"object","properties":{"corroboration_id":{"type":"string","format":"uuid","description":"The UUID of the corroboration: call list_corroborations to find it."}},"required":["corroboration_id"]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"convert_corroboration_to_surface","title":"Move a corroboration to the surface registry","description":"Move the page to the surface registry: the customer has, or takes, the final say on it (their own profile or listing recorded on the wrong side, or a source that became a reliable channel). Nothing is retyped: url, label and notes travel, the publication date is copied into the notes, the type derives from the address. The corroboration is taken down, sheet intact, and the reverse move exists (convert_surface_to_corroboration): nothing is lost, and replaying the move finds the same line instead of duplicating it. It moves a line the customer declared: confirm with the user first.","inputSchema":{"type":"object","properties":{"corroboration_id":{"type":"string","format":"uuid","description":"The UUID of the corroboration: call list_corroborations to find it."}},"required":["corroboration_id"]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"list_corroboration_candidates","title":"List pages where the engines showed the brand","description":"The MENTIONS a search engine has shown the brand in, found in the text the engine itself returned next to each address. The list is recomputed on every read from the raw payloads of the latest surveys, and surveys_scanned says how many were read. Pages already filed in either registry (corroborations or surfaces) are left out. Each row carries the excerpt as proof, matched_by (\"website\" means the full domain of the brand appears in it, near proof; \"name\" means only the name did, weaker, homonyms exist: read the page before recording) and suggested: the registry the filing is proposed in (\"surface\" when the host is a known profile place, a page the customer usually has the final say on; \"corroboration\" otherwise). Once the page itself has been read, the row also carries page_check: result is \"website\" or \"name\" when the page carries the brand, \"absent\" when the page reads without it, and it names the cause when the text did not come: \"blocked\" (an anti-bot stands in front of the page), \"unreachable\" (the page did not answer), \"no_page\" (the address answers with something that is not a page), \"unreadable\" (the page answers HTML with no text in it). In those four the engine excerpt above stays the proof shown. excerpt is a full passage taken from the page, and checked_at dates the reading. It is a suggestion, never a filing: to file one, call create_corroboration or create_surface with its url; to refuse one, dismiss_corroboration_candidate.","inputSchema":{"type":"object","properties":{"project_id":{"type":"string","format":"uuid","description":"UUID of the project: call list_projects to find it."}},"required":["project_id"]},"annotations":{"readOnlyHint":true,"openWorldHint":false}},{"name":"dismiss_corroboration_candidate","title":"Refuse a corroboration candidate","description":"Refuse a suggested page: it is never proposed again for this project. Use it when the excerpt matched something else than the brand, or when the page is not worth recording. Nothing is created or deleted. Accepting is the opposite move and has no tool of its own: call create_corroboration with the url of the candidate, or create_surface when the page is one the customer controls.","inputSchema":{"type":"object","properties":{"project_id":{"type":"string","format":"uuid","description":"UUID of the project: call list_projects to find it."},"url":{"type":"string","description":"The address of the candidate, exactly as list_corroboration_candidates gives it."}},"required":["project_id","url"]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_logbook","title":"Read the logbook of a project","description":"The logbook of a project, newest first: every dated move, composed from two sources. source=tool events are derived from the suite itself (canon moved to a version, surface marked aligned, corroboration recorded); source=manual entries are actions the customer recorded (only these carry an id, a category, a label and notes). Each move also lands as an annotation on the citation curves of the trackers of the project: read the logbook to tell what was done when the curves moved. A canon_version item carries changed, the canon keys that revision touched (one_liner, short, long, category, language, perks, website, legal_name, address, phone, whatsapp, email), so you can drive the re-propagation from here: it names what to rewrite on the pages that restate those fields, and version 1 lists everything it posted. On a corroboration item, occurred_at is the PUBLICATION date when known and the recording date otherwise: published_on sits next to it, and it tells which of the two dates the move carries. Set deleted to \"only\" to read the trash of the logbook instead of it.","inputSchema":{"type":"object","properties":{"project_id":{"type":"string","format":"uuid","description":"UUID of the project: call list_projects to find it."},"source":{"type":"string","enum":["tool","manual"],"description":"Only the items of this source: \"tool\" for suite events, \"manual\" for recorded entries. Omitted, both."},"category":{"type":"string","enum":["content","technical","translation","canon","press","other"],"description":"Only the manual entries of this category (tool events carry no category and never match)."},"deleted":{"type":"string","enum":["only"],"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."}},"required":["project_id"]},"annotations":{"readOnlyHint":true,"openWorldHint":false}},{"name":"create_logbook_entry","title":"Record an action in the logbook","description":"Record an action in the logbook of a project: what was done, and WHEN it was done. occurred_at is the date of the ACTION itself, not of the recording: recording after the fact is the normal case (\"record: site translated into Spanish yesterday\" means occurred_at is yesterday). The entry joins the tool events in the logbook and lands as an annotation on the citation curves of the trackers of the project, so the action can be read against the measures. Recording is idempotent on the project, the label and occurred_at: calling again with the same three returns the entry already recorded instead of a second copy, so a retry is safe. The same move recorded in two languages has two labels, so it stays two entries.","inputSchema":{"type":"object","properties":{"project_id":{"type":"string","format":"uuid","description":"UUID of the project: call list_projects to find it."},"category":{"type":"string","enum":["content","technical","translation","canon","press","other"],"description":"What kind of action this is; it files the entry for filtering. \"other\" covers anything else."},"label":{"type":"string","description":"Short wording of the action, e.g. \"Site translated into Spanish\": it is what the annotation shows next to the citation curves."},"occurred_at":{"type":"string","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."},"notes":{"type":"string","description":"Free notes: context, links, details of the action."}},"required":["project_id","category","label"]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"update_logbook_entry","title":"Edit a logbook entry","description":"Edit a manual logbook entry: only the fields you send change (empty notes clear them). It is the customer's own logbook: a typo or a wrong date is simply corrected. Tool events cannot be edited: they are derived from the canon and surface registries.","inputSchema":{"type":"object","properties":{"entry_id":{"type":"string","format":"uuid","description":"The UUID of the logbook entry: call get_logbook to find it (only manual entries carry an id)."},"category":{"type":"string","enum":["content","technical","translation","canon","press","other"],"description":"What kind of action this is; it files the entry for filtering. \"other\" covers anything else."},"label":{"type":"string","description":"Short wording of the action, e.g. \"Site translated into Spanish\": it is what the annotation shows next to the citation curves."},"occurred_at":{"type":"string","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."},"notes":{"type":"string","description":"Free notes: context, links, details of the action."}},"required":["entry_id"]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"delete_logbook_entry","title":"Delete a logbook entry","description":"Take a manual logbook entry out of the logbook, and the annotation it placed on the curves with it. Only do it when the user asked for it: it is their logbook. The entry waits in the trash, so restore_logbook_entry brings it back with its annotation. Tool events stay as they are: they are derived from the canon and surface registries.","inputSchema":{"type":"object","properties":{"entry_id":{"type":"string","format":"uuid","description":"The UUID of the logbook entry: call get_logbook to find it (only manual entries carry an id)."}},"required":["entry_id"]},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false}},{"name":"restore_logbook_entry","title":"Bring a logbook entry back","description":"Bring an entry back to the logbook, with the annotation it placed on the curves. Call get_logbook with deleted set to \"only\" to find the entries to bring back. Restoring an entry already in the logbook answers the same.","inputSchema":{"type":"object","properties":{"entry_id":{"type":"string","format":"uuid","description":"The UUID of the logbook entry: call get_logbook to find it (only manual entries carry an id)."}},"required":["entry_id"]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"list_quests","title":"Read the quest file","description":"What there is to do for the GEO work, and where to resume it. Lists the quests of the account: moves the customer (or you, on their behalf) decided and recorded, open by default, newest first; status=done or dismissed reads the closed history, which answers with its quests, each one reopened with reopen_quest. Every project by default; scope to one project with project_id. Alongside the open file, `pending` carries the files the measurement is holding for review, each acted through its own tool: surfaces whose canon moved since their last alignment (list_surfaces, then tick_surface_checklist to verify the cells the new wording perished), keyword discoveries waiting on a tracker (list_keyword_discoveries, then accept_keyword_discovery or dismiss_keyword_discovery). Scoped to one project, `pending` also carries the corroboration candidates of that project, computed per project (list_corroboration_candidates, then create_corroboration or dismiss_corroboration_candidate). An empty file with the measurement running means there is nothing to correct today.","inputSchema":{"type":"object","properties":{"project_id":{"type":"string","format":"uuid","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."},"status":{"type":"string","enum":["open","done","dismissed"],"description":"Which quests to list: \"open\" (the file, default), \"done\" or \"dismissed\" (the closed history)."}}},"annotations":{"readOnlyHint":true,"openWorldHint":false}},{"name":"create_quest","title":"Add a quest","description":"Add a quest to the file of a project: a next move the customer decided, kept where the work resumes (\"get our MCP server listed on the AI tool directories\"). title says the move; notes carry context and links. Adding is idempotent on the project and title while the quest is open: calling again returns the quest already in the file instead of a second copy, so a retry is safe. A closed quest with the same title does not block: doing the move again later is a new quest, with its own history.","inputSchema":{"type":"object","properties":{"project_id":{"type":"string","format":"uuid","description":"UUID of the project whose file takes the quest: call list_projects to find it."},"title":{"type":"string","description":"Short wording of the move, e.g. \"Get our MCP server listed on the AI tool directories\": it is what the file shows."},"notes":{"type":"string","description":"Free notes: context, links, what done looks like."}},"required":["project_id","title"]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"update_quest","title":"Edit a quest","description":"Edit a quest: only the fields you send change (empty notes clear them). It is the customer's own file: a typo or a sharpened wording is simply corrected. The status changes through its own moves, complete_quest, dismiss_quest and reopen_quest.","inputSchema":{"type":"object","properties":{"quest_id":{"type":"string","format":"uuid","description":"The UUID of the quest: call list_quests to find it."},"title":{"type":"string","description":"Short wording of the move, e.g. \"Get our MCP server listed on the AI tool directories\": it is what the file shows."},"notes":{"type":"string","description":"Free notes: context, links, what done looks like."}},"required":["quest_id"]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"complete_quest","title":"Complete a quest","description":"Mark a quest done: the move happened. Sets the state and the closing date; calling it again leaves it done, so a retry is safe, and a dismissed quest that was done after all becomes done (the last move is what the file remembers). The quest stays readable in the closed history of list_quests, and reopen_quest puts it back in the file.","inputSchema":{"type":"object","properties":{"quest_id":{"type":"string","format":"uuid","description":"The UUID of the quest: call list_quests to find it."}},"required":["quest_id"]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"dismiss_quest","title":"Dismiss a quest","description":"Set a quest aside: the customer decided the move is off. Sets the state and the closing date; calling it again leaves it dismissed, so a retry is safe. The quest stays readable in the closed history of list_quests, and reopen_quest puts it back in the file.","inputSchema":{"type":"object","properties":{"quest_id":{"type":"string","format":"uuid","description":"The UUID of the quest: call list_quests to find it."}},"required":["quest_id"]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"reopen_quest","title":"Reopen a quest","description":"Put a closed quest back in the file: it returns among the open moves with its sheet as it was, the date it was added, its author and its notes, so a quest closed by mistake or taken up again keeps its own history. Clears the closing date; calling it again leaves it open, so a retry is safe. Call list_quests with status done or dismissed to find the quest to reopen.","inputSchema":{"type":"object","properties":{"quest_id":{"type":"string","format":"uuid","description":"The UUID of the quest: call list_quests to find it."}},"required":["quest_id"]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_results","title":"Get the score series","description":"The score series of a tracker: one row per analyst, keyword, engine, tracker version and survey period, in chronological order. Depending on the analyst, a row carries citation_rate and weighted_score, share_of_voice, or sentiment counts.","inputSchema":{"type":"object","properties":{"tracker_id":{"type":"string","format":"uuid","description":"The UUID of the tracker: call list_trackers to find it."},"analyst":{"type":"string","enum":["keyword_presence","share_of_voice","sentiment"],"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."},"engine":{"type":"string","enum":["chatgpt","claude","gemini","perplexity","mistral","grok"],"description":"Only the rows of this engine."}},"required":["tracker_id"]},"annotations":{"readOnlyHint":true,"openWorldHint":false}},{"name":"get_responses","title":"Get raw responses","description":"The raw answers of ONE AI engine for a tracker, newest surveys first, paginated. Every answer carries its cited sources and keyword mentions, plus uncited_sources (the pages the engine read without citing them) and searched (whether the engine went to the web to write that answer; null when undetermined). Set include_raw to add the full engine payload; heavy, ask for it only when needed.","inputSchema":{"type":"object","properties":{"tracker_id":{"type":"string","format":"uuid","description":"The UUID of the tracker: call list_trackers to find it."},"engine":{"type":"string","enum":["chatgpt","claude","gemini","perplexity","mistral","grok"],"description":"The engine whose answers are read."},"page":{"type":"integer","minimum":1,"description":"Page number, 1 by default."},"per_page":{"type":"integer","minimum":1,"maximum":100,"description":"Answers per page, 25 by default, 100 at most."},"q":{"type":"string","description":"Full-text filter on the answer text."},"question":{"type":"string","description":"Exact text of one tracked question."},"survey":{"type":"string","format":"uuid","description":"Only the answers of this survey."},"tone":{"type":"string","enum":["positive","neutral","negative"],"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."},"include_raw":{"type":"boolean","description":"Add the full engine payload to every answer."}},"required":["tracker_id","engine"]},"annotations":{"readOnlyHint":true,"openWorldHint":false}},{"name":"list_keyword_discoveries","title":"List discovered keyword suggestions","description":"The keyword suggestions DISCOVERED on a tracker: domains the surveyed engines cite as sources again and again, that no tracked keyword covers. Recomputed on every read, from the recurrences the surveys have accumulated. Also carries dismissed, the domains this tracker has set aside: what was refused stays readable, so you can restore one with restore_keyword_discovery if the user changes their mind. The two lists are disjoint (a dismissed domain is never suggested). Relay the suggestions to the user: the decision to track a name is theirs.","inputSchema":{"type":"object","properties":{"tracker_id":{"type":"string","format":"uuid","description":"The UUID of the tracker: call list_trackers to find it."}},"required":["tracker_id"]},"annotations":{"readOnlyHint":true,"openWorldHint":false}},{"name":"accept_keyword_discovery","title":"Accept discovered suggestions","description":"Accept one discovered suggestion (domain) or a batch (domains): each becomes a tracked keyword of the tracker, in place, and its series starts at the next survey. Refused with keyword_cap_reached when the batch would exceed the keyword cap, and with not_found when a domain is not currently suggested (the batch is all-or-nothing, nothing is added then). The answer carries keyword for a single domain, keywords for a batch. Accept on behalf of the user only when they said yes.","inputSchema":{"type":"object","properties":{"tracker_id":{"type":"string","format":"uuid","description":"The UUID of the tracker: call list_trackers to find it."},"domain":{"type":"string","description":"One domain to act on, exactly as listed by list_keyword_discoveries. Send this OR domains, never both."},"domains":{"type":"array","items":{"type":"string"},"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."}},"required":["tracker_id"]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"dismiss_keyword_discovery","title":"Dismiss discovered suggestions","description":"Dismiss one discovered suggestion (domain) or a batch (domains): the domains are never proposed again on this tracker, and appear in the dismissed list until restored. All-or-nothing on unknown domains: one that is not currently suggested refuses the whole batch (not_found). Dismissing an already dismissed domain is fine, it does not fail the batch. The answer carries dismissed as the domain for a single call, the list for a batch.","inputSchema":{"type":"object","properties":{"tracker_id":{"type":"string","format":"uuid","description":"The UUID of the tracker: call list_trackers to find it."},"domain":{"type":"string","description":"One domain to act on, exactly as listed by list_keyword_discoveries. Send this OR domains, never both."},"domains":{"type":"array","items":{"type":"string"},"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."}},"required":["tracker_id"]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"restore_keyword_discovery","title":"Restore dismissed suggestions","description":"Restore one dismissed domain (domain) or a batch (domains): it leaves the tracker dismissed list and becomes eligible for discovery again, suggested anew while the engines keep citing it (accepting it stays a distinct move). The counterpart of dismiss, for when the user changes their mind. Idempotent and never refused: restoring a domain that was not dismissed simply leaves it eligible. The answer carries restored as the domain for a single call, the list for a batch.","inputSchema":{"type":"object","properties":{"tracker_id":{"type":"string","format":"uuid","description":"The UUID of the tracker: call list_trackers to find it."},"domain":{"type":"string","description":"One domain to act on, exactly as listed by list_keyword_discoveries. Send this OR domains, never both."},"domains":{"type":"array","items":{"type":"string"},"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."}},"required":["tracker_id"]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"list_competitor_scans","title":"List the competitor scans","description":"The competitor scans of the account, newest first: a basket of 3 to 5 companies of one market, asked to one engine, from which the scan returns THE PLACES that corroborate them. `status` says where each one stands: draft (questions still open, nothing charged), measuring, ready (there is a list to read), failed. `rescan_cadence` says whether it repeats. Without the list of places, which the fiche carries: call get_competitor_scan for one scan. Scope to one project with project_id.","inputSchema":{"type":"object","properties":{"project_id":{"type":"string","format":"uuid","description":"Only the scans of this project: the UUID of a project of the account (call list_projects). Omitted, every project."}}},"annotations":{"readOnlyHint":true,"openWorldHint":false}},{"name":"get_competitor_scan","title":"Read a competitor scan","description":"One scan and its list of PLACES: the domains the engine cited while answering about the basket, ranked by how many of its companies each place covers (`subjects`, the number that carries the tool) then by AI Authority. Each place carries `reach`, the way in: self_serve (open your own page there), participate (a forum or a community), ask (a third-party editorial site, the most frequent), registry (the page follows an official filing). `client_present` says whether the account already has a corroboration recorded there. The list ACCUMULATES over every check of the scan, deduplicated by URL, so `seen_in_checks` counts checks and never citations: a place every pass brings back is a steady one. `controlled` is what each company publishes on its own site, and `rivals` the competitive set. To act on a place, add a quest with create_quest carrying its URL.","inputSchema":{"type":"object","properties":{"competitor_scan_id":{"type":"string","format":"uuid","description":"The UUID of the competitor scan: call list_competitor_scans to find it."}},"required":["competitor_scan_id"]},"annotations":{"readOnlyHint":true,"openWorldHint":false}},{"name":"create_competitor_scan","title":"Prepare a competitor scan","description":"Prepare a competitor scan on a basket of 3 to 5 companies of the same market. It is created as a DRAFT: nothing is charged, and the questions it derives come back in the answer for you to read before arming it with start_competitor_scan. Each subject needs a `website`: a whole domain found in a page is what tells two companies with the same name apart. `category` qualifies each company in the questions (\"welding equipment manufacturer\") and `usage` says what buyers use it for (\"hobby welding\"); both shape the questions, so name them from the market you are measuring. `language` is the language the questions are asked in and `country` the market they name; leave country out for a global one. One engine per scan, ChatGPT by default: a second engine is a second scan.","inputSchema":{"type":"object","properties":{"project_id":{"type":"string","format":"uuid","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."},"subjects":{"type":"array","minItems":3,"maxItems":5,"items":{"type":"object","properties":{"name":{"type":"string","description":"The company as the market names it, for example \"Lincoln Electric\"."},"website":{"type":"string","description":"Its site, for example \"lincolnelectric.com\". Required: it is what identifies the company exactly."}},"required":["name","website"]},"description":"The basket: 3 to 5 companies of the same market."},"category":{"type":"string","description":"What qualifies each company in the questions, for example \"welding equipment manufacturer\"."},"usage":{"type":"string","description":"What buyers use it for, for example \"hobby welding\". Omitted, the category serves."},"engine":{"type":"string","enum":["chatgpt","claude","gemini","perplexity","mistral","grok"],"description":"The engine asked, ChatGPT by default. One per scan."},"language":{"type":"string","description":"The language the questions are asked in, for example \"en\". Omitted, the canonical language of the project."},"country":{"type":"string","description":"The market the questions name, as an ISO 3166-1 alpha-2 code (\"US\"). Omitted, the questions name no country."},"title":{"type":"string","description":"A name for the scan. Omitted, the category serves."}},"required":["project_id","subjects","category"]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"start_competitor_scan","title":"Arm a competitor scan","description":"Arm a prepared scan: the engine is asked, and the prepaid balance is debited by the amount `estimated_cost_minor` announced on the scan. SPENDS: read that amount to the person and get their go-ahead before calling. The answers land within a few minutes; read the places back with get_competitor_scan. Safe to replay: a scan already armed answers with itself instead of paying for a second one.","inputSchema":{"type":"object","properties":{"competitor_scan_id":{"type":"string","format":"uuid","description":"The UUID of the competitor scan: call list_competitor_scans to find it."}},"required":["competitor_scan_id"]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"update_competitor_scan","title":"Set the rescan cadence","description":"Set how often an armed scan runs again: \"monthly\" sets it, null stops it. Each pass widens the list rather than refreshing it, because two checks of the same question do not cite the same pages, and what one check found the next one keeps. SPENDS on every pass, the same amount as the first one, so name it to the person before setting a cadence. It states a STATE and replays safely both ways: setting the cadence already in place moves nothing, and stopping it leaves the accumulated list intact.","inputSchema":{"type":"object","properties":{"competitor_scan_id":{"type":"string","format":"uuid","description":"The UUID of the competitor scan: call list_competitor_scans to find it."},"rescan_cadence":{"type":["string","null"],"enum":["monthly",null],"description":"How often the scan runs again: \"monthly\", or null to stop it."}},"required":["competitor_scan_id"]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"list_sources","title":"Search the Atlas of sources","description":"The Atlas: the sources the AIs cite when they answer YOUR trackers. Each entry is a domain with its AI Authority on each AI, a 0 to 100 scale over the last 30 days where 100 is the source that AI cites the most. An engine with no value has not cited the domain lately, which is not a zero. Each AI has its own leader, so its own scale: each column ranks the sources on its own AI, the rankings being almost disjoint. The map carries the sources surfaced by the surveys of this account, so it grows as the account measures more; filter it to one brand with project_id. The scale, on the other hand, is computed across every measurement Epovest runs, which is what makes it stable. Use it to see where an answer comes from on a subject, and which places are worth existing on. The unit is the registrable domain, so a subdomain is folded into it and a hosting platform counts as one source, not one per author.","inputSchema":{"type":"object","properties":{"domain":{"type":"string","description":"Keep only the domains containing this text, e.g. \"wikipedia\" or \".fr\"."},"engine":{"type":"string","enum":["chatgpt","claude","gemini","perplexity","mistral","grok"],"description":"Keep only the sources this engine has cited at least once."},"project_id":{"type":"string","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."},"sort":{"type":"string","enum":["detections","engines","freshness","domain","aa_chatgpt","aa_claude","aa_gemini","aa_perplexity","aa_mistral","aa_grok"],"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\"."},"page":{"type":"integer","minimum":1,"description":"Page number, from 1."},"per_page":{"type":"integer","minimum":1,"maximum":100,"description":"Entries per page, 25 by default, 100 at most."}}},"annotations":{"readOnlyHint":true,"openWorldHint":false}},{"name":"get_source","title":"Read one source of the Atlas","description":"One entry of the Atlas, read by its id: the domain and its AI Authority on each AI. Call list_sources to find a source id, or to read the same entries filtered and ranked.","inputSchema":{"type":"object","properties":{"source_id":{"type":"string","format":"uuid","description":"The UUID of the source: call list_sources to find it."}},"required":["source_id"]},"annotations":{"readOnlyHint":true,"openWorldHint":false}},{"name":"get_account_settings","title":"Read the account settings","description":"The settings of the account: the legal name, billing country, postal address and intra-EU VAT number printed on its invoices, plus the language we write to it in and the time zone its hours are shown in. `member` names the person the language and the time zone belong to. Read it before update_account_settings: the answer gives every setting as it stands, so you change the one the user named and leave the others alone.","inputSchema":{"type":"object","properties":{}},"annotations":{"readOnlyHint":true,"openWorldHint":false}},{"name":"update_account_settings","title":"Update the account settings","description":"Change the settings of the account. Send only what the user is changing: every setting you leave out keeps its value. `billing_country`, `billing_address` and `intra_eu_vat_number` clear when you send null; `name`, `language` and `timezone` keep their value on null, so name the language or the time zone you want. A postal address and a VAT number travel with `billing_country`: send the country in the same call. What you write here goes on the next invoices of the account, and the invoices already issued keep the details they carry.","inputSchema":{"type":"object","properties":{"name":{"type":"string","description":"Legal name of the account, the one printed on its invoices."},"billing_country":{"type":"string","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."},"billing_address":{"type":"array","items":{"type":"string"},"maxItems":3,"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."},"intra_eu_vat_number":{"type":"string","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."},"language":{"type":"string","enum":["en","fr","es","de","it","pt"],"description":"The language we write to this account in: emails, and the hosted payment page of a top-up."},"timezone":{"type":"string","description":"The time zone the hours of the account are shown in, as an IANA identifier: \"Europe/Paris\", \"America/New_York\", \"UTC\"."}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_credits","title":"Get the credit balance","description":"The prepaid credit balance of the account: available credits, which never expire, and the amount reserved by surveys in progress with the detail of each reservation. Read it before starting a tracker, or when a call fails with insufficient_credits. It also carries what a top-up is worth here, so you never have to work it out: `monthly_estimate_minor` is what the account has set up to consume in a month, and `suggested_topups[]` gives three amounts derived from it, each with `amount_minor`, `amount` (major units) and `covers_months`, the runway it buys at that pace. `min_topup_minor` is the floor a top-up has to clear. When the account consumes nothing yet, `monthly_estimate_minor` is 0 and `suggested_topups` is empty: ask the person what they want to measure, and the amounts appear as soon as a tracker is configured.","inputSchema":{"type":"object","properties":{}},"annotations":{"readOnlyHint":true,"openWorldHint":false}},{"name":"get_usage","title":"Get what the account has spent","description":"What the account SPENDS: one call, three answers, and they must never be mixed up. (1) THIS MONTH, a FORECAST: `this_month_forecast` gives `total_minor` for the month in progress, which is `spent_minor` (already debited) plus `remaining_minor` (what the active trackers and monitored corroborations will still run before month end, counted as real occurrences and recomputed from their configuration). Report it as a forecast, never as spend, and say the month. (2) PER MONTH, actual: `by_month[]` gives, for each of the last 12 months, `month` (YYYY-MM), `spent_minor`, and the same amount by project and by tracker. This is what the wallet was really debited. `months_total` says how many months have spend, so you can tell whether 12 covered everything. (3) OVER THE WINDOW, actual: `total_spent_minor` with `by_project[]` and `by_tracker[]` (biggest spender first) is a cumulative total over `period` (`from` and `to`, the first and last debit counted), never a monthly figure: quote the period alongside the amount. `entries[]` carries the ledger itself. Spend is broken down by COST LINE everywhere, in `lines` and `by_category`: `survey` (the checks themselves), `ai_analyst` (the supplement of the AI analysts grafted onto them), `competitor_scan` (a one-off scan of a basket of competitors, run from the app on the same check grid, which carries its own line and stays out of `by_tracker`), `corroboration_check` (monitored corroborations, one debit per check run) and `other` for a line the tool does not name yet, which stays visible rather than dropping out of a total. Amounts are in minor units of the wallet currency. Filter a single month with `month` (YYYY-MM), and the entries alone with `type` (`in` for top-ups, `out` for spend). Every tracker line carries `tracker_id`, ready for get_results or get_responses, and `listed` says whether that tracker is still in the account list. Each entry is stamped with `created_at`, the exact instant it was posted (RFC 3339, to the second, with the fraction the ledger recorded): an active account posts dozens of entries a day, so quote the time along with the date and let it order the entries of one day. On a check debit, `on_demand` says where the check came from: `true` for one asked for with survey_now, `false` for one the tracker cadence ran, `null` on an entry that is not a check debit. Separate the two when reporting spend, since one is a decision the account made and the other is the schedule running. Entries are paginated and `page` is CLAMPED: stop on `page >= pages`. get_credits gives what is left to spend.","inputSchema":{"type":"object","properties":{"month":{"type":"string","pattern":"^\\d{4}-\\d{2}$","description":"A single month, YYYY-MM. Omitted: every month the account has entries for."},"type":{"type":"string","enum":["all","in","out"],"description":"Which entries to return: all (default), in (top-ups and adjustments), out (spend)."},"page":{"type":"integer","minimum":1},"per_page":{"type":"integer","minimum":1,"maximum":100}}},"annotations":{"readOnlyHint":true,"openWorldHint":false}},{"name":"topup_credits","title":"Buy credits","description":"Prepare a top-up of the prepaid credit balance and return the hosted payment link. Nothing is charged by this call: hand payment_url to the user, the payment happens there, and they approve the amount on that page. When the user names an amount, that amount wins: pass it as `amount`, exactly the number they said. Amounts are always in the wallet currency of the account, which get_credits gives: if they name another currency, tell them, never convert one currency into another yourself. When they leave it to you, take one of the amounts get_credits already suggests in `suggested_topups[]` and pass its `amount_minor`: they are derived from what this account consumes, they clear the floor, and each says the runway it buys in `covers_months`. Name the one you picked and what it covers. Nothing to compute, and nothing to convert. Send one of the two, never both. The minimum top-up is 10.00 (1000 minor units). Once paid, the balance updates on its own and paused trackers resume.","inputSchema":{"type":"object","properties":{"amount":{"type":"number","exclusiveMinimum":0,"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."},"amount_minor":{"type":"integer","exclusiveMinimum":0,"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."}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"contact_support","title":"Write to the Epovest support team","description":"Send a message to the humans behind Epovest: report a problem, suggest an improvement, ask a question. Use it when a tool refuses what should work, when the product is missing something the user needs, or when the user asks you to tell us something. The message lands in the support threads of the account, which the members also see in the app, and a human answers there. Reply to an ongoing thread with thread_id, and read the answer with get_support_thread.","inputSchema":{"type":"object","properties":{"message":{"type":"string","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."},"subject":{"type":"string","description":"Title of the thread. Derived from the message when omitted; ignored when replying."},"kind":{"type":"string","enum":["problem","suggestion","question"],"description":"What this message is: sorts it on arrival."},"thread_id":{"type":"string","format":"uuid","description":"Reply to this thread instead of opening a new one: call list_support_threads to find it."}},"required":["message"]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"list_support_threads","title":"List support threads","description":"The support threads of the account, most recent first: what was asked, and whether the support team has answered. The threads are shared by the members of the account, whatever wrote them.","inputSchema":{"type":"object","properties":{}},"annotations":{"readOnlyHint":true,"openWorldHint":false}},{"name":"get_support_thread","title":"Read a support thread","description":"One support thread with its messages, including the answers of the support team. Read it back after contact_support to relay the answer to the user.","inputSchema":{"type":"object","properties":{"thread_id":{"type":"string","format":"uuid","description":"The UUID of the support thread: call list_support_threads to find it."}},"required":["thread_id"]},"annotations":{"readOnlyHint":true,"openWorldHint":false}}]}},"http_status":200,"headers":{"content-type":"application/json","strict-transport-security":"max-age=31536000; includeSubDomains"}}},"prompts_list":{"status":"auth_required","latency_ms":127.75,"details":{"url":"https://mcp.epovest.com/mcp","error":"Client error '401 Unauthorized' for url 'https://mcp.epovest.com/mcp'\nFor more information check: https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/401","http_status":401,"payload":{},"headers":{"content-type":"application/json","www-authenticate":"Bearer realm=\"epovest-api\", resource_metadata=\"https://mcp.epovest.com/.well-known/oauth-protected-resource/mcp\"","strict-transport-security":"max-age=31536000; includeSubDomains"},"reason":"auth_required"}},"prompt_get":{"status":"missing","latency_ms":null,"details":{"reason":"not_advertised"}},"resources_list":{"status":"auth_required","latency_ms":367.18,"details":{"url":"https://mcp.epovest.com/mcp","error":"Client error '401 Unauthorized' for url 'https://mcp.epovest.com/mcp'\nFor more information check: https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/401","http_status":401,"payload":{},"headers":{"content-type":"application/json","www-authenticate":"Bearer realm=\"epovest-api\", resource_metadata=\"https://mcp.epovest.com/.well-known/oauth-protected-resource/mcp\"","strict-transport-security":"max-age=31536000; includeSubDomains"},"reason":"auth_required"}},"resource_read":{"status":"missing","latency_ms":null,"details":{"reason":"not_advertised"}},"determinism_probe":{"status":"ok","latency_ms":398.07,"details":{"attempts":2,"successful":2,"matches":2,"stable_ratio":1.0,"baseline_signature":"03dfd070608929939fe1218518508c73c64430413bd6503ae4ab8ef37d95d36b","errors":[]}},"instruction_tool_reference_probe":{"status":"warning","latency_ms":null,"details":{"referenced_tools":["returns"],"missing_tools":["returns"],"observed_tool_count":66}},"session_resume_probe":{"status":"warning","latency_ms":null,"details":{"reason":"no_session_id","transport":"streamable-http","resume_expected":true,"protocol_version":"2025-03-26"}},"step_up_auth_probe":{"status":"ok","latency_ms":null,"details":{"oauth_present":true,"auth_required_checks":["prompts_list","resources_list"],"supported_scopes":["read","write"],"scope_specificity_ratio":0.5,"broad_scopes":["write"],"challenge_headers":["Bearer realm=\"epovest-api\", resource_metadata=\"https://mcp.epovest.com/.well-known/oauth-protected-resource/mcp\"","Bearer realm=\"epovest-api\", resource_metadata=\"https://mcp.epovest.com/.well-known/oauth-protected-resource/mcp\""],"step_up_signals":["Bearer realm=\"epovest-api\", resource_metadata=\"https://mcp.epovest.com/.well-known/oauth-protected-resource/mcp\"","Bearer realm=\"epovest-api\", resource_metadata=\"https://mcp.epovest.com/.well-known/oauth-protected-resource/mcp\""],"minimal_scope_documented":true}},"transport_compliance_probe":{"status":"warning","latency_ms":130.34,"details":{"transport":"streamable-http","session_id_present":false,"protocol_header_present":false,"last_event_id_visible":false,"requested_protocol_version":"2025-03-26","bad_protocol_status_code":400,"bad_protocol_payload":{"jsonrpc":"2.0","id":410,"error":{"code":-32022,"message":"Unsupported protocol version.","data":{"supported":["2026-07-28","2025-06-18","2025-03-26","2024-11-05"],"requested":"1999-99-99"}}},"bad_protocol_headers":{"content-type":"application/json","strict-transport-security":"max-age=31536000; includeSubDomains"},"bad_protocol_error":null,"delete_status_code":null,"delete_error":null,"expired_session_status_code":null,"expired_session_error":null,"issues":["missing_session_id","missing_protocol_header"]}},"utility_coverage_probe":{"status":"ok","latency_ms":128.43,"details":{"completions":{"advertised":false,"sample_target":null,"live_probe":"not_executed"},"pagination":{"supported":false,"next_cursor_methods":[],"metadata_signal":false},"tasks":{"advertised":false,"probe_status":"auth_required","http_status":401},"initialize_capability_keys":["tools"]}},"advanced_capabilities_probe":{"status":"warning","latency_ms":null,"details":{"capabilities":{"prompts":true,"resources":true,"completions":false,"roots":false,"sampling":false,"elicitation":false,"structured_outputs":false,"resource_links":false},"enabled_count":2,"enabled":["prompts","resources"],"initialize_capability_keys":["tools"]}},"tool_snapshot_probe":{"status":"ok","latency_ms":null,"details":{"current_tool_count":66,"previous_tool_count":66,"similarity":1.0,"added":[],"removed":[],"changed_outputs":[]}},"connector_replay_probe":{"status":"ok","latency_ms":null,"details":{"backward_compatible":true,"would_break_after_refresh":false,"added_tools":[],"removed_tools":[],"required_arg_breaks":[],"output_breaks":[],"additive_output_changes":[]}},"request_association_probe":{"status":"missing","latency_ms":null,"details":{"reason":"no_request_association_capabilities_advertised"}},"interactive_flow_probe":{"status":"ok","latency_ms":null,"details":{"risk_hits":[],"safe_hits":[],"oauth_supported":true,"prompt_available":false}},"action_safety_probe":{"status":"warning","latency_ms":null,"details":{"summary":{"tool_count":66,"high_risk_tools":1,"destructive_tools":5,"exec_tools":0,"egress_tools":10,"secret_tools":0,"bulk_access_tools":0,"declared_non_read_only_tools":45,"annotation_conflict_tools":0,"risk_distribution":{"low":32,"medium":33,"high":1,"critical":0},"capability_distribution":{"read":21,"write":31,"undetermined":12,"delete":5,"network":10,"financial":2},"has_mutating_capability":true,"has_non_read_capability":true},"auth_present":true,"safeguard_count":9,"confirmation_signals":["update_project_canon","set_link_targets","tick_surface_checklist","convert_surface_to_corroboration","create_corroboration","convert_corroboration_to_surface","create_logbook_entry","create_quest","restore_keyword_discovery","topup_credits"],"reason":null}},"official_registry_probe":{"status":"missing","latency_ms":null,"details":{"registry_source":"glama_registry","direct_match":false,"official_peer_count":0}},"provenance_divergence_probe":{"status":"not_assessed","latency_ms":null,"details":{"direct_official_match":false,"registry_title":null,"server_card_title":null,"registry_version":null,"server_card_version":null,"registry_homepage":null,"server_card_homepage":null,"registry_repository":null,"server_card_repository":null,"drift_fields":[],"metadata_document_count":1,"compared_fields":["title","version","homepage","repository"],"readable_sources":[],"comparable_field_count":0}},"schema_divergence_probe":{"status":"missing","latency_ms":null,"details":{"reason":"no_server_card_tools","compared_tool_count":0,"compared_dimensions":["server_name","server_version","declared_vs_observed_auth","tool_membership","parameter_names","required_parameters","parameter_types","output_schema_presence"],"server_name_mismatch":false,"card_server_name":null,"live_server_name":"epovest","server_version_mismatch":false,"card_server_version":null,"live_server_version":"1.0.0","auth_scheme_mismatch":false}},"connector_publishability_probe":{"status":"warning","latency_ms":null,"details":{"transport":"streamable-http","tool_count":66,"high_risk_tools":1,"blockers":["protocol_version","session_resume","transport_compliance","request_association","action_safety","server_card"],"criteria":{"remote_transport":true,"initialize":true,"tools_list":true,"protocol_version":false,"session_resume":false,"step_up_auth":true,"transport_compliance":false,"connector_replay":true,"request_association":false,"action_safety":false,"server_card":false,"tool_surface":true,"auth_flow":true}}}}},"active_alerts":[{"code":"instruction_tool_reference_mismatch","severity":"low","title":"Server instructions name unavailable tools","message":"Initialize instructions reference tools not present in tools/list: returns","addressee":"publisher"}],"maintainer_analytics":{},"public_server_reputation":{},"maintainer_response_quality":{},"maintainer_annotations":[],"maintainer_rebuttals":[],"security_posture_summary":{},"tool_security_inventory":[],"transport_compliance":{},"utility_coverage":{},"write_action_governance":{},"provenance_divergence":{},"alias_consolidation":{},"alert_routing":{},"authenticated_validation":{},"hosted_runtime":{},"action_controls_diff":null,"benchmark_tasks":[],"latest_capability_counts":{},"point_loss_breakdown":[],"verdict_traces":{},"current_snapshot":{"schema_version":"verify.trust_snapshot.v1","snapshot_id":"trustsnap_3bdde9009ffcd96e","generated_at":"2026-08-15T18:22:58.787517+00:00","trust_evaluated_at":"2026-08-15T18:22:58.787517+00:00","evidence_revision":"53850c6df2e025eb3d3da38e","source":"current_snapshot","server":"Epovest/mcp-server","last_validated_at":"2026-08-15T16:05:07.926953+00:00","validation_age_hours":2.3,"freshness":{"schema_version":"verify.freshness_profile.v1","last_validated_at":"2026-08-15T16:05:07.926953+00:00","age_hours":2.3,"bucket":"verified_last_24h","label":"Verified in last 24h","badges":["verified_last_24h"],"freshness_sla_hours":720.0,"freshness_sla_status":"met","stale_score_suppressed":false,"display_score":69.27,"raw_score":69.27,"confidence_score":100.0,"confidence_weighted_score":69.3,"tier_status":[{"tier":"community","label":"Community","freshness_sla_hours":720,"met":true,"priority_revalidation":false},{"tier":"pro","label":"Pro","freshness_sla_hours":168,"met":true,"priority_revalidation":true},{"tier":"enterprise","label":"Enterprise","freshness_sla_hours":24,"met":true,"priority_revalidation":true}]},"current_status":"healthy","current_score":69.27,"display_score":69.27,"stale_score_suppressed":false,"production_trust_decision":{"schema_version":"verify.executive_verdict.v1","decision":"Allow with approval","why":"write/admin actions need confirmation safeguards + unauthenticated behavior not proven","next_action":"export policy, require approval for writes, add authenticated validation","reason_count":2},"production_readiness_class":{"code":"safe_for_evaluation","label":"Safe for evaluation","reason":"The server is suitable for evaluation, but remaining gaps should be resolved before broad production use."},"evidence_confidence":{"score":100.0,"label":"high","validation_age_hours":2.3,"live_check_count":18,"basis":{"evidence_bearing_validations":20,"affirmative_live_check_count":18,"validation_age_hours":2.3,"freshness_threshold_hours":24}},"active_alerts":[{"code":"instruction_tool_reference_mismatch","severity":"low","title":"Server instructions name unavailable tools"}],"active_alert_summary":{"critical":0,"high":0,"medium":0,"low":1,"high_or_critical":0,"total":1},"materialization":{"state":"partial","trust_core_complete":true,"fields_unavailable":["tool_security_inventory","security_posture_summary","write_action_governance","capability_taxonomy","remediations"],"materialized_at":"2026-08-15T18:22:58.787517+00:00"}},"trust_snapshot":{"schema_version":"verify.trust_snapshot.v1","snapshot_id":"trustsnap_3bdde9009ffcd96e","generated_at":"2026-08-15T18:22:58.787517+00:00","trust_evaluated_at":"2026-08-15T18:22:58.787517+00:00","evidence_revision":"53850c6df2e025eb3d3da38e","source":"current_snapshot","server":"Epovest/mcp-server","last_validated_at":"2026-08-15T16:05:07.926953+00:00","validation_age_hours":2.3,"freshness":{"schema_version":"verify.freshness_profile.v1","last_validated_at":"2026-08-15T16:05:07.926953+00:00","age_hours":2.3,"bucket":"verified_last_24h","label":"Verified in last 24h","badges":["verified_last_24h"],"freshness_sla_hours":720.0,"freshness_sla_status":"met","stale_score_suppressed":false,"display_score":69.27,"raw_score":69.27,"confidence_score":100.0,"confidence_weighted_score":69.3,"tier_status":[{"tier":"community","label":"Community","freshness_sla_hours":720,"met":true,"priority_revalidation":false},{"tier":"pro","label":"Pro","freshness_sla_hours":168,"met":true,"priority_revalidation":true},{"tier":"enterprise","label":"Enterprise","freshness_sla_hours":24,"met":true,"priority_revalidation":true}]},"current_status":"healthy","current_score":69.27,"display_score":69.27,"stale_score_suppressed":false,"production_trust_decision":{"schema_version":"verify.executive_verdict.v1","decision":"Allow with approval","why":"write/admin actions need confirmation safeguards + unauthenticated behavior not proven","next_action":"export policy, require approval for writes, add authenticated validation","reason_count":2},"production_readiness_class":{"code":"safe_for_evaluation","label":"Safe for evaluation","reason":"The server is suitable for evaluation, but remaining gaps should be resolved before broad production use."},"evidence_confidence":{"score":100.0,"label":"high","validation_age_hours":2.3,"live_check_count":18,"basis":{"evidence_bearing_validations":20,"affirmative_live_check_count":18,"validation_age_hours":2.3,"freshness_threshold_hours":24}},"active_alerts":[{"code":"instruction_tool_reference_mismatch","severity":"low","title":"Server instructions name unavailable tools"}],"active_alert_summary":{"critical":0,"high":0,"medium":0,"low":1,"high_or_critical":0,"total":1},"materialization":{"state":"partial","trust_core_complete":true,"fields_unavailable":["tool_security_inventory","security_posture_summary","write_action_governance","capability_taxonomy","remediations"],"materialized_at":"2026-08-15T18:22:58.787517+00:00"}},"agent_commerce":{},"latest_claim":null,"maintainer_profile_slug":null,"watch_summary":{},"partial":true,"fields_unavailable":["tool_security_inventory","security_posture_summary","write_action_governance","capability_taxonomy","remediations"],"trust_evaluated_at":"2026-08-15T18:22:58.787517+00:00","evidence_revision":"53850c6df2e025eb3d3da38e","active_alert_summary":{"critical":0,"high":0,"medium":0,"low":1,"high_or_critical":0,"total":1},"materialization":{"state":"partial","trust_core_complete":true,"fields_unavailable":["tool_security_inventory","security_posture_summary","write_action_governance","capability_taxonomy","remediations"],"materialized_at":"2026-08-15T18:22:58.787517+00:00"},"owner_opted_out":false},"latest_validation":null,"current_snapshot":{"schema_version":"verify.trust_snapshot.v1","snapshot_id":"trustsnap_3bdde9009ffcd96e","generated_at":"2026-08-15T18:22:58.787517+00:00","trust_evaluated_at":"2026-08-15T18:22:58.787517+00:00","evidence_revision":"53850c6df2e025eb3d3da38e","source":"current_snapshot","server":"Epovest/mcp-server","last_validated_at":"2026-08-15T16:05:07.926953+00:00","validation_age_hours":2.3,"freshness":{"schema_version":"verify.freshness_profile.v1","last_validated_at":"2026-08-15T16:05:07.926953+00:00","age_hours":2.3,"bucket":"verified_last_24h","label":"Verified in last 24h","badges":["verified_last_24h"],"freshness_sla_hours":720.0,"freshness_sla_status":"met","stale_score_suppressed":false,"display_score":69.27,"raw_score":69.27,"confidence_score":100.0,"confidence_weighted_score":69.3,"tier_status":[{"tier":"community","label":"Community","freshness_sla_hours":720,"met":true,"priority_revalidation":false},{"tier":"pro","label":"Pro","freshness_sla_hours":168,"met":true,"priority_revalidation":true},{"tier":"enterprise","label":"Enterprise","freshness_sla_hours":24,"met":true,"priority_revalidation":true}]},"current_status":"healthy","current_score":69.27,"display_score":69.27,"stale_score_suppressed":false,"production_trust_decision":{"schema_version":"verify.executive_verdict.v1","decision":"Allow with approval","why":"write/admin actions need confirmation safeguards + unauthenticated behavior not proven","next_action":"export policy, require approval for writes, add authenticated validation","reason_count":2},"production_readiness_class":{"code":"safe_for_evaluation","label":"Safe for evaluation","reason":"The server is suitable for evaluation, but remaining gaps should be resolved before broad production use."},"evidence_confidence":{"score":100.0,"label":"high","validation_age_hours":2.3,"live_check_count":18,"basis":{"evidence_bearing_validations":20,"affirmative_live_check_count":18,"validation_age_hours":2.3,"freshness_threshold_hours":24}},"active_alerts":[{"code":"instruction_tool_reference_mismatch","severity":"low","title":"Server instructions name unavailable tools"}],"active_alert_summary":{"critical":0,"high":0,"medium":0,"low":1,"high_or_critical":0,"total":1},"materialization":{"state":"partial","trust_core_complete":true,"fields_unavailable":["tool_security_inventory","security_posture_summary","write_action_governance","capability_taxonomy","remediations"],"materialized_at":"2026-08-15T18:22:58.787517+00:00"}},"trust_snapshot":{"schema_version":"verify.trust_snapshot.v1","snapshot_id":"trustsnap_3bdde9009ffcd96e","generated_at":"2026-08-15T18:22:58.787517+00:00","trust_evaluated_at":"2026-08-15T18:22:58.787517+00:00","evidence_revision":"53850c6df2e025eb3d3da38e","source":"current_snapshot","server":"Epovest/mcp-server","last_validated_at":"2026-08-15T16:05:07.926953+00:00","validation_age_hours":2.3,"freshness":{"schema_version":"verify.freshness_profile.v1","last_validated_at":"2026-08-15T16:05:07.926953+00:00","age_hours":2.3,"bucket":"verified_last_24h","label":"Verified in last 24h","badges":["verified_last_24h"],"freshness_sla_hours":720.0,"freshness_sla_status":"met","stale_score_suppressed":false,"display_score":69.27,"raw_score":69.27,"confidence_score":100.0,"confidence_weighted_score":69.3,"tier_status":[{"tier":"community","label":"Community","freshness_sla_hours":720,"met":true,"priority_revalidation":false},{"tier":"pro","label":"Pro","freshness_sla_hours":168,"met":true,"priority_revalidation":true},{"tier":"enterprise","label":"Enterprise","freshness_sla_hours":24,"met":true,"priority_revalidation":true}]},"current_status":"healthy","current_score":69.27,"display_score":69.27,"stale_score_suppressed":false,"production_trust_decision":{"schema_version":"verify.executive_verdict.v1","decision":"Allow with approval","why":"write/admin actions need confirmation safeguards + unauthenticated behavior not proven","next_action":"export policy, require approval for writes, add authenticated validation","reason_count":2},"production_readiness_class":{"code":"safe_for_evaluation","label":"Safe for evaluation","reason":"The server is suitable for evaluation, but remaining gaps should be resolved before broad production use."},"evidence_confidence":{"score":100.0,"label":"high","validation_age_hours":2.3,"live_check_count":18,"basis":{"evidence_bearing_validations":20,"affirmative_live_check_count":18,"validation_age_hours":2.3,"freshness_threshold_hours":24}},"active_alerts":[{"code":"instruction_tool_reference_mismatch","severity":"low","title":"Server instructions name unavailable tools"}],"active_alert_summary":{"critical":0,"high":0,"medium":0,"low":1,"high_or_critical":0,"total":1},"materialization":{"state":"partial","trust_core_complete":true,"fields_unavailable":["tool_security_inventory","security_posture_summary","write_action_governance","capability_taxonomy","remediations"],"materialized_at":"2026-08-15T18:22:58.787517+00:00"}},"partial":true,"fields_unavailable":["tool_security_inventory","security_posture_summary","write_action_governance","capability_taxonomy","remediations"],"snapshot_invariant":{"schema_version":"verify.snapshot_invariant.v1","server":"Epovest/mcp-server","ok":true,"surface_snapshot_ids":{"page":"trustsnap_3bdde9009ffcd96e","badge":null,"report":"trustsnap_3bdde9009ffcd96e","policy":null},"checked_surfaces":["page","report"],"unchecked_surfaces":["badge","policy"],"checked_count_surfaces":[],"count_mismatches":{},"checked_at":"2026-08-15T18:22:58.759356+00:00"},"history":{},"production_readiness":{"code":"safe_for_evaluation","label":"Safe for evaluation","reason":"The server is suitable for evaluation, but remaining gaps should be resolved before broad production use.","badge":"score-medium","critical_alerts":0,"high_or_critical_alerts":0,"degraded_by_active_alerts":false},"agent_commerce_readiness":{},"evidence_confidence":{"score":100.0,"label":"high","reason":"Based on 20 recent validations, 18 captured checks, and validation age of 2.3 hours.","live_check_count":18,"validation_age_hours":2.3,"basis":{"evidence_bearing_validations":20,"affirmative_live_check_count":18,"validation_age_hours":2.3,"freshness_threshold_hours":24}},"recommended_for":[],"active_alerts":[{"code":"instruction_tool_reference_mismatch","severity":"low","title":"Server instructions name unavailable tools","message":"Initialize instructions reference tools not present in tools/list: returns","addressee":"publisher"}],"remediations":[],"cache_note":"Fast fallback response; full report evidence is deferred to protect web capacity. Fields listed in fields_unavailable (including tool_security_inventory, and write_action_governance) are not yet computed on this response -- an empty value means unchecked, not confirmed clean. Treat partial responses as indeterminate.","publisher_claim":{"verified":false,"status":"unclaimed","claim_url":"https://verify.sentinelsignal.io/claim?server=Epovest%2Fmcp-server&source=report_json","reason_code":"claim_to_publish_metadata","reason":"Claim this profile to verify publisher identity, add evidence, and manage trust metadata.","score_neutral":true},"observed_attention":{"schema":"verify.observed_attention.v1","window_days":30,"level":"none","label":"No observed attention","summary":"No recent machine-readable trust or discovery activity observed for this server.","segments":{"useful_ai_user":{"level":"none","observed":false,"description":"AI-assisted user sessions such as ChatGPT/User or Claude/User."},"machine_trust_evaluator":{"level":"none","observed":false,"description":"Synthetic sessions inspecting multiple trust surfaces such as report, policy, ledger, badge, trust-summary, or compare."},"possible_agent_or_script":{"level":"none","observed":false,"description":"Structured direct sessions with rapid profile, compare, report, policy, badge, or trust-surface fan-out."},"isolated_machine_surface":{"level":"none","observed":false,"description":"Aged-out direct synthetic singleton sessions that touched a machine-readable trust surface without becoming a broader evaluator."},"ai_crawler":{"level":"none","observed":false,"description":"Known AI crawler activity such as ClaudeBot, GPTBot, or similar crawlers."},"search_crawler":{"level":"none","observed":false,"description":"Search and SEO crawler activity."},"browser_like_automation":{"level":"none","observed":false,"description":"Browser-like synthetic sessions with rapid structured endpoint activity."},"confirmed_human":{"level":"none","observed":false,"description":"Confirmed browser-session human activity."}},"surfaces_observed":{"server_profile":false,"compare":false,"compare_json":false,"compare_api":false,"report_json":false,"policy":false,"ledger":false,"badge_metadata":false,"badge_svg":false,"trust_summary":false,"mcp_tool":false},"claim_prompt":{"recommended":false,"reason":"No claim prompt is recommended from observed attention in the current window."},"notes":["Observed attention is based on segmented first-party telemetry.","Crawler and evaluator activity is not treated as confirmed human demand.","Public levels are bucketed to avoid exposing raw traffic counts."]},"owner_activation":{"claim_recommended":false,"reason":"no_observed_attention"},"related_machine_surfaces":{"compare_index":"/compare.json","compare_api":"/v1/compare?server=Epovest%2Fmcp-server","trust_summary":"/v1/servers/Epovest/mcp-server/trust-summary","ledger":"/v1/servers/Epovest/mcp-server/ledger","policy":"/v1/servers/Epovest/mcp-server/policy","report":"/v1/servers/Epovest/mcp-server/report"},"intelligence_api":{"available":true,"signup_url":"https://verify.sentinelsignal.io/verify-intelligence-api","use_case":"Programmatic MCP server trust, comparison, policy, and evidence enrichment."},"trust_evaluated_at":"2026-08-15T18:22:58.787517+00:00","evidence_revision":"53850c6df2e025eb3d3da38e","active_alert_summary":{"critical":0,"high":0,"medium":0,"low":1,"high_or_critical":0,"total":1},"materialization":{"state":"partial","trust_core_complete":true,"fields_unavailable":["tool_security_inventory","security_posture_summary","write_action_governance","capability_taxonomy","remediations"],"materialized_at":"2026-08-15T18:22:58.787517+00:00"}}