{"$schema":"https://static.modelcontextprotocol.io/schemas/mcp-server-card/v1.json","version":"1.0","protocolVersion":"2025-11-25","serverInfo":{"name":"debriefing","title":"Debriefing","version":"2.0.0"},"description":"Work on one Debriefing workspace as a signed-in person: read tracked competitors, evidence-backed signals, digests, and battlecards, and, with the write and spend scopes, change the watchlist, act on signals, and run research. Without signing in, search and read the competitive briefs and CI guides Debriefing publishes on debriefing.io.","iconUrl":"https://debriefing.io/icon-light.png","documentationUrl":"https://debriefing.io/developers?tab=mcp","transport":{"type":"streamable-http","endpoint":"https://debriefing.io/mcp"},"capabilities":{"tools":{"listChanged":false}},"authentication":{"required":true,"schemes":["oauth2","bearer"],"scopes":["read","write","spend"]},"instructions":"Claude, ChatGPT, and other OAuth clients connect with OAuth: the person signs in to Debriefing, approves the app, and chooses the scopes: read (always), write (changes that cost nothing), and spend (actions that use a plan allowance). Other clients send an API key as Authorization: Bearer <key> or X-API-Key: <key>; a key works as the admin who created it. tools/list needs no credential. The public tools (search_public_briefs, get_public_brief, search_guides, get_free_brief_link) need none either: they read only the briefs and guides published on debriefing.io, and declare securitySchemes noauth. Every other tools/call needs a credential. Each tool checks its scope, the person's role, and the plan, and a refusal comes back as isError with the link that fixes it. Every signal carries its evidence; cite it.","tools":[{"name":"get_workspace","title":"Get workspace","description":"Gets the Debriefing workspace this connection works on: its name and website, who you are in it and your role, the scopes this connection holds, and the plan. Call it first when you are not sure what you may do.","inputSchema":{"type":"object","properties":{},"additionalProperties":false},"outputSchema":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"website_url":{"type":["string","null"]},"url":{"type":"string"},"you":{"type":["object","null"]},"connection":{"type":"object"},"plan":{"type":"object"},"counts":{"type":"object"}},"required":["id","name","connection","plan"]},"annotations":{"title":"Get workspace","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["read"]}],"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["read"]}],"openai/toolInvocation/invoking":"Reading the workspace","openai/toolInvocation/invoked":"Read the workspace"}},{"name":"get_plan_and_limits","title":"Get plan and limits","description":"Gets the workspace plan and every limit an agent runs into: competitor slots, the weekly research allowance, the daily caps on battlecards, ICP refreshes and positioning drafts, share link lifetimes, monitoring cadences, and which features need a paid plan. Includes the pricing link.","inputSchema":{"type":"object","properties":{},"additionalProperties":false},"outputSchema":{"type":"object","properties":{"plan":{"type":"object"},"competitor_slots":{"type":"object"},"research_allowance":{"type":"object"},"daily_caps":{"type":"object"},"share_link_expiry_choices":{"type":"array","items":{"type":"string"}},"monitoring_cadences":{"type":"object"},"features":{"type":"object"},"pricing_url":{"type":"string"}},"required":["plan","competitor_slots","research_allowance","daily_caps","features","pricing_url"]},"annotations":{"title":"Get plan and limits","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["read"]}],"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["read"]}],"openai/toolInvocation/invoking":"Reading the plan and limits","openai/toolInvocation/invoked":"Read the plan and limits"}},{"name":"list_competitors","title":"List competitors","description":"Lists the competitors this Debriefing workspace tracks, with the id, name, website, and category of each. Call it first to get the competitor_id that other tools take.","inputSchema":{"type":"object","properties":{},"additionalProperties":false},"outputSchema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object"}}},"required":["items"]},"annotations":{"title":"List competitors","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["read"]}],"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["read"]}],"openai/toolInvocation/invoking":"Reading tracked competitors","openai/toolInvocation/invoked":"Read tracked competitors"}},{"name":"get_competitor","title":"Get competitor dossier","description":"Gets the dossier for one tracked competitor: company facts, the risk and opportunity it poses to this workspace, and the stored reads on positioning, product, pricing, funding, traffic, and more. Use it when the user asks about one competitor in depth.","inputSchema":{"type":"object","properties":{"competitor_id":{"type":"integer","description":"An id from list_competitors"}},"required":["competitor_id"],"additionalProperties":false},"outputSchema":{"type":"object"},"annotations":{"title":"Get competitor dossier","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["read"]}],"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["read"]}],"openai/toolInvocation/invoking":"Reading the competitor dossier","openai/toolInvocation/invoked":"Read the competitor dossier"}},{"name":"search_signals","title":"Search signals","description":"Searches open signals, newest first. A signal is a competitor move that Debriefing found, such as a price change or a launch, with the source evidence. Filter by competitor_id, severity (low, medium, high), a text query, or a since time. Use it when the user asks what a competitor changed.","inputSchema":{"type":"object","properties":{"competitor_id":{"type":"integer","description":"An id from list_competitors"},"severity":{"type":"string","enum":["low","medium","high"]},"query":{"type":"string","description":"Words to find in the signal title or summary"},"since":{"type":"string","description":"ISO 8601 time. Only signals after this time."},"limit":{"type":"integer","minimum":1,"maximum":50}},"additionalProperties":false},"outputSchema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object"}}},"required":["items"]},"annotations":{"title":"Search signals","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["read"]}],"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["read"]}],"openai/toolInvocation/invoking":"Searching signals","openai/toolInvocation/invoked":"Searched signals"}},{"name":"list_digests","title":"List digests","description":"Lists the digests Debriefing wrote for this workspace, newest first. A digest is a brief that sums up competitor moves over a period. Filter by type, such as daily_digest.","inputSchema":{"type":"object","properties":{"type":{"type":"string","description":"A digest type, such as daily_digest or weekly_tldr"},"limit":{"type":"integer","minimum":1,"maximum":50}},"additionalProperties":false},"outputSchema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object"}}},"required":["items"]},"annotations":{"title":"List digests","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["read"]}],"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["read"]}],"openai/toolInvocation/invoking":"Reading digests","openai/toolInvocation/invoked":"Read digests"}},{"name":"get_digest","title":"Get digest","description":"Gets one digest by id or slug, or the newest digest when no id is given. Pass type daily_digest for the newest daily digest. Use it when the user asks for the latest brief.","inputSchema":{"type":"object","properties":{"id":{"type":"string","description":"A digest id or slug from list_digests"},"type":{"type":"string","description":"A digest type, such as daily_digest"}},"additionalProperties":false},"outputSchema":{"type":"object"},"annotations":{"title":"Get digest","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["read"]}],"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["read"]}],"openai/toolInvocation/invoking":"Reading the digest","openai/toolInvocation/invoked":"Read the digest"}},{"name":"list_battlecards","title":"List battlecards","description":"Lists the battlecards Debriefing wrote for this workspace, one for each competitor that has one. A battlecard holds talk tracks for sales calls against that competitor.","inputSchema":{"type":"object","properties":{},"additionalProperties":false},"outputSchema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object"}}},"required":["items"]},"annotations":{"title":"List battlecards","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["read"]}],"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["read"]}],"openai/toolInvocation/invoking":"Reading battlecards","openai/toolInvocation/invoked":"Read battlecards"}},{"name":"get_battlecard","title":"Get battlecard","description":"Gets one battlecard by competitor_id or battlecard_id. Use it when the user prepares a sales call against a competitor.","inputSchema":{"type":"object","properties":{"competitor_id":{"type":"integer","description":"An id from list_competitors"},"battlecard_id":{"type":"integer","description":"An id from list_battlecards"}},"additionalProperties":false},"outputSchema":{"type":"object"},"annotations":{"title":"Get battlecard","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["read"]}],"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["read"]}],"openai/toolInvocation/invoking":"Reading the battlecard","openai/toolInvocation/invoked":"Read the battlecard"}},{"name":"get_evidence","title":"Get signal evidence","description":"Gets the evidence behind one signal: each source excerpt with its URL and date. Use it when the user asks where a claim comes from.","inputSchema":{"type":"object","properties":{"signal_id":{"type":"integer","description":"An id from search_signals"}},"required":["signal_id"],"additionalProperties":false},"outputSchema":{"type":"object"},"annotations":{"title":"Get signal evidence","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["read"]}],"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["read"]}],"openai/toolInvocation/invoking":"Reading the evidence","openai/toolInvocation/invoked":"Read the evidence"}},{"name":"add_competitor","title":"Add competitor","description":"Adds a competitor to the workspace's core watchlist from its website. Debriefing then monitors it. Admin only. The plan sets how many core competitors fit; get_plan_and_limits shows the free slots.","inputSchema":{"type":"object","properties":{"website_url":{"type":"string","maxLength":500,"description":"The competitor's website, such as https://acme.example"}},"required":["website_url"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"ok":{"type":"boolean"},"message":{"type":"string"},"competitor":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"website_url":{"type":"string"}}}},"required":["ok","message"]},"annotations":{"title":"Add competitor","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["write"]}],"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["write"]}],"openai/toolInvocation/invoking":"Adding the competitor","openai/toolInvocation/invoked":"Added the competitor"}},{"name":"rename_competitor","title":"Rename competitor","description":"Changes the display name of one tracked competitor. Admin only.","inputSchema":{"type":"object","properties":{"competitor_id":{"type":"integer","description":"An id from list_competitors"},"name":{"type":"string","minLength":1,"maxLength":255}},"required":["competitor_id","name"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"ok":{"type":"boolean"},"message":{"type":"string"},"competitor":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"website_url":{"type":"string"}}}},"required":["ok","message"]},"annotations":{"title":"Rename competitor","readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["write"]}],"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["write"]}],"openai/toolInvocation/invoking":"Renaming the competitor","openai/toolInvocation/invoked":"Renamed the competitor"}},{"name":"remove_competitor","title":"Remove competitor","description":"Takes one core competitor off the watchlist. Debriefing stops monitoring it and keeps its history. Admin only, on a paid plan.","inputSchema":{"type":"object","properties":{"competitor_id":{"type":"integer","description":"An id from list_competitors"}},"required":["competitor_id"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"ok":{"type":"boolean"},"message":{"type":"string"},"competitor":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"website_url":{"type":"string"}}}},"required":["ok","message"]},"annotations":{"title":"Remove competitor","readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["write"]}],"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["write"]}],"openai/toolInvocation/invoking":"Removing the competitor","openai/toolInvocation/invoked":"Removed the competitor"}},{"name":"add_monitored_page","title":"Monitor a competitor page","description":"Asks Debriefing to watch one more page of a core competitor, such as its pricing page. Changes on it then show up as signals. Up to 10 pages per competitor. Admin only, on a paid plan.","inputSchema":{"type":"object","properties":{"competitor_id":{"type":"integer","description":"An id from list_competitors"},"url":{"type":"string","maxLength":2000,"description":"The full page address"}},"required":["competitor_id","url"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"ok":{"type":"boolean"},"message":{"type":"string"},"page":{"type":"object"},"monitored_pages":{"type":"array","items":{"type":"object"}}},"required":["ok","message"]},"annotations":{"title":"Monitor a competitor page","readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["write"]}],"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["write"]}],"openai/toolInvocation/invoking":"Adding the page","openai/toolInvocation/invoked":"Added the page"}},{"name":"remove_monitored_page","title":"Stop monitoring a page","description":"Stops watching a page that someone added on a core competitor. Name it by page_id or url. Admin only, on a paid plan.","inputSchema":{"type":"object","properties":{"competitor_id":{"type":"integer","description":"An id from list_competitors"},"page_id":{"type":"integer","description":"An id from add_monitored_page"},"url":{"type":"string","maxLength":2000}},"required":["competitor_id"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"ok":{"type":"boolean"},"message":{"type":"string"},"monitored_pages":{"type":"array","items":{"type":"object"}}},"required":["ok","message"]},"annotations":{"title":"Stop monitoring a page","readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["write"]}],"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["write"]}],"openai/toolInvocation/invoking":"Removing the page","openai/toolInvocation/invoked":"Removed the page"}},{"name":"research_competitor","title":"Research a competitor","description":"Starts the first research on one core competitor that has none yet: Debriefing reads its site and outside sources. It uses one update from the weekly research allowance. Admin only.","inputSchema":{"type":"object","properties":{"competitor_id":{"type":"integer","description":"An id from list_competitors"},"idempotency_key":{"type":"string","minLength":1,"maxLength":200,"description":"A unique string you make for this request, such as a UUID. Send the same key when you retry, and Debriefing returns the first answer instead of acting twice."}},"required":["competitor_id","idempotency_key"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"ok":{"type":"boolean"},"message":{"type":"string"},"refresh":{"type":"object"},"replayed":{"type":"boolean","description":"True when this answer repeats an earlier call with the same idempotency_key."}},"required":["ok","message"]},"annotations":{"title":"Research a competitor","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"securitySchemes":[{"type":"oauth2","scopes":["spend"]}],"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["spend"]}],"openai/toolInvocation/invoking":"Starting the research","openai/toolInvocation/invoked":"Started the research"}},{"name":"refresh_watchlist","title":"Refresh the watchlist","description":"Refreshes the research on the core watchlist now, instead of at the next cycle. It uses one update from the weekly research allowance. Admin only.","inputSchema":{"type":"object","properties":{"idempotency_key":{"type":"string","minLength":1,"maxLength":200,"description":"A unique string you make for this request, such as a UUID. Send the same key when you retry, and Debriefing returns the first answer instead of acting twice."}},"additionalProperties":false,"required":["idempotency_key"]},"outputSchema":{"type":"object","properties":{"ok":{"type":"boolean"},"message":{"type":"string"},"refresh":{"type":"object"},"replayed":{"type":"boolean","description":"True when this answer repeats an earlier call with the same idempotency_key."}},"required":["ok","message"]},"annotations":{"title":"Refresh the watchlist","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"securitySchemes":[{"type":"oauth2","scopes":["spend"]}],"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["spend"]}],"openai/toolInvocation/invoking":"Refreshing the watchlist","openai/toolInvocation/invoked":"Started the refresh"}},{"name":"pin_signal","title":"Pin a signal","description":"Pins a signal for the whole team, or removes the pin with pinned false.","inputSchema":{"type":"object","properties":{"signal_id":{"type":"integer","description":"An id from search_signals or what_changed"},"pinned":{"type":"boolean","default":true}},"required":["signal_id"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"ok":{"type":"boolean"},"message":{"type":"string"},"signal_id":{"type":"integer"},"pinned":{"type":"boolean"}},"required":["ok","message"]},"annotations":{"title":"Pin a signal","readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["write"]}],"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["write"]}],"openai/toolInvocation/invoking":"Pinning the signal","openai/toolInvocation/invoked":"Updated the pin"}},{"name":"save_signal","title":"Save a signal","description":"Saves a signal to your own saved list, or removes it with saved false. Only you see your saved signals.","inputSchema":{"type":"object","properties":{"signal_id":{"type":"integer","description":"An id from search_signals or what_changed"},"saved":{"type":"boolean","default":true}},"required":["signal_id"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"ok":{"type":"boolean"},"message":{"type":"string"},"signal_id":{"type":"integer"},"saved":{"type":"boolean"}},"required":["ok","message"]},"annotations":{"title":"Save a signal","readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["write"]}],"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["write"]}],"openai/toolInvocation/invoking":"Saving the signal","openai/toolInvocation/invoked":"Updated the save"}},{"name":"add_signal_note","title":"Add a talking point to a signal","description":"Adds a talking point to a signal. The team sees it in the workspace. It never appears on a public link unless the link includes notes.","inputSchema":{"type":"object","properties":{"signal_id":{"type":"integer","description":"An id from search_signals or what_changed"},"body":{"type":"string","minLength":1,"maxLength":2000,"description":"The talking point, in plain text"}},"required":["signal_id","body"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"ok":{"type":"boolean"},"message":{"type":"string"},"note":{"type":"object"}},"required":["ok","message"]},"annotations":{"title":"Add a talking point to a signal","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["write"]}],"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["write"]}],"openai/toolInvocation/invoking":"Adding the talking point","openai/toolInvocation/invoked":"Added the talking point"}},{"name":"rate_signal","title":"Rate a signal","description":"Tells Debriefing whether a signal was useful to you. For not useful, add reasons and a comment. A new rating replaces your old one.","inputSchema":{"type":"object","properties":{"signal_id":{"type":"integer","description":"An id from search_signals or what_changed"},"useful":{"type":"boolean"},"reasons":{"type":"array","items":{"type":"string","enum":["wrong","old_news","not_relevant","already_knew"]},"description":"Only when useful is false"},"comment":{"type":"string","maxLength":2000}},"required":["signal_id","useful"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"ok":{"type":"boolean"},"message":{"type":"string"},"rating":{"type":"object"}},"required":["ok","message"]},"annotations":{"title":"Rate a signal","readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["write"]}],"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["write"]}],"openai/toolInvocation/invoking":"Rating the signal","openai/toolInvocation/invoked":"Rated the signal"}},{"name":"pin_digest","title":"Pin a digest","description":"Pins a digest for the whole team, or removes the pin with pinned false.","inputSchema":{"type":"object","properties":{"digest_id":{"type":"string","description":"A digest id or slug from list_digests"},"pinned":{"type":"boolean","default":true}},"required":["digest_id"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"ok":{"type":"boolean"},"message":{"type":"string"},"digest_id":{"type":"integer"},"pinned":{"type":"boolean"}},"required":["ok","message"]},"annotations":{"title":"Pin a digest","readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["write"]}],"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["write"]}],"openai/toolInvocation/invoking":"Pinning the digest","openai/toolInvocation/invoked":"Updated the pin"}},{"name":"add_digest_note","title":"Add a talking point to a digest","description":"Adds a talking point to a digest. The team sees it in the workspace.","inputSchema":{"type":"object","properties":{"digest_id":{"type":"string","description":"A digest id or slug from list_digests"},"body":{"type":"string","minLength":1,"maxLength":2000,"description":"The talking point, in plain text"}},"required":["digest_id","body"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"ok":{"type":"boolean"},"message":{"type":"string"},"note":{"type":"object"}},"required":["ok","message"]},"annotations":{"title":"Add a talking point to a digest","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["write"]}],"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["write"]}],"openai/toolInvocation/invoking":"Adding the talking point","openai/toolInvocation/invoked":"Added the talking point"}},{"name":"rate_digest","title":"Rate a digest","description":"Scores a digest from 1 to 5, says what is missing from it, or both. A new rating replaces your old one.","inputSchema":{"type":"object","properties":{"digest_id":{"type":"string","description":"A digest id or slug from list_digests"},"score":{"type":"integer","minimum":1,"maximum":5},"comment":{"type":"string","maxLength":2000,"description":"What is missing from the digest"}},"required":["digest_id"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"ok":{"type":"boolean"},"message":{"type":"string"},"rating":{"type":"object"}},"required":["ok","message"]},"annotations":{"title":"Rate a digest","readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["write"]}],"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["write"]}],"openai/toolInvocation/invoking":"Rating the digest","openai/toolInvocation/invoked":"Rated the digest"}},{"name":"generate_battlecard","title":"Write a battlecard","description":"Writes or rewrites the battlecard for one core competitor now, instead of at the next cycle. It takes about a minute; read it afterwards with get_battlecard. The competitor needs finished research. Needs a paid plan or the free first week, and counts toward a daily cap per workspace.","inputSchema":{"type":"object","properties":{"competitor_id":{"type":"integer","description":"An id from list_competitors"},"idempotency_key":{"type":"string","minLength":1,"maxLength":200,"description":"A unique string you make for this request, such as a UUID. Send the same key when you retry, and Debriefing returns the first answer instead of acting twice."}},"required":["competitor_id","idempotency_key"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"ok":{"type":"boolean"},"message":{"type":"string"},"competitor":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"website_url":{"type":"string"}}},"daily_cap":{"type":"object"},"replayed":{"type":"boolean","description":"True when this answer repeats an earlier call with the same idempotency_key."}},"required":["ok","message"]},"annotations":{"title":"Write a battlecard","readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["spend"]}],"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["spend"]}],"openai/toolInvocation/invoking":"Writing the battlecard","openai/toolInvocation/invoked":"Started the battlecard"}},{"name":"add_battlecard_note","title":"Add a note to a battlecard","description":"Adds what the team knows about a core competitor that no page says. The next rewrite of its battlecard reads the note as framing, never as a verified fact.","inputSchema":{"type":"object","properties":{"competitor_id":{"type":"integer","description":"An id from list_competitors"},"body":{"type":"string","minLength":1,"maxLength":2000,"description":"The talking point, in plain text"}},"required":["competitor_id","body"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"ok":{"type":"boolean"},"message":{"type":"string"},"note":{"type":"object"}},"required":["ok","message"]},"annotations":{"title":"Add a note to a battlecard","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["write"]}],"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["write"]}],"openai/toolInvocation/invoking":"Adding the note","openai/toolInvocation/invoked":"Added the note"}},{"name":"get_company_profile","title":"Get company profile","description":"Gets the workspace's own company profile: description, category, target customer, positioning lists, and the ideal customer profile. Debriefing reads every competitor move against it.","inputSchema":{"type":"object","properties":{},"additionalProperties":false},"outputSchema":{"type":"object","properties":{"profile":{"type":"object"},"positioning":{"type":"object"},"ideal_customer_profile":{"type":"object"},"locked":{"type":"boolean"},"url":{"type":"string"}},"required":["profile","positioning","ideal_customer_profile","locked"]},"annotations":{"title":"Get company profile","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["read"]}],"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["read"]}],"openai/toolInvocation/invoking":"Reading the company profile","openai/toolInvocation/invoked":"Read the company profile"}},{"name":"update_company_profile","title":"Update company profile","description":"Changes fields of the workspace's company profile. Only the fields you send change. The lists replace the old lists. Admin only. Locked while the first brief runs.","inputSchema":{"type":"object","properties":{"name":{"type":"string","maxLength":255},"website_url":{"type":"string","maxLength":500},"description":{"type":"string","maxLength":2000},"industry":{"type":"string"},"primary_category":{"type":"string"},"target_customer":{"type":"string"},"self_positioning":{"type":"string"},"company_size":{"type":"integer","minimum":1},"company_type":{"type":"string","enum":["software_vendor","service_provider","marketplace","ecommerce_brand","media_publisher","nonprofit","government","fintech_institution","healthcare_provider","manufacturer","education_provider","other"]},"hq_country":{"type":"string"},"operating_regions":{"type":"array","items":{"type":"string"},"description":"Regions where the company sells"},"market_position":{"type":"string"},"market_direction":{"type":"string"},"value_propositions":{"type":"array","items":{"type":"string"},"description":"Up to 12 short items"},"differentiators":{"type":"array","items":{"type":"string"},"description":"Up to 12 short items"},"positioning_exclusions":{"type":"array","items":{"type":"string"},"description":"What the company does not do. Up to 12 short items"}},"additionalProperties":false},"outputSchema":{"type":"object","properties":{"ok":{"type":"boolean"},"message":{"type":"string"},"profile":{"type":"object"},"positioning":{"type":"object"}},"required":["ok","message"]},"annotations":{"title":"Update company profile","readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["write"]}],"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["write"]}],"openai/toolInvocation/invoking":"Updating the company profile","openai/toolInvocation/invoked":"Updated the company profile"}},{"name":"update_icp","title":"Update ideal customer profile","description":"Sets the ideal customer profile, then re-reads how much each tracked competitor overlaps it. Only the dimensions you send change; an empty list clears one. Admin only. Counts toward a daily cap per workspace. Locked while the first brief runs.","inputSchema":{"type":"object","properties":{"customer_types":{"type":"array","items":{"type":"string"},"description":"Customer types"},"company_sizes":{"type":"array","items":{"type":"string"},"description":"Company sizes"},"company_stages":{"type":"array","items":{"type":"string"},"description":"Company stages"},"industries":{"type":"array","items":{"type":"string"},"description":"Industries"},"geographies":{"type":"array","items":{"type":"string"},"description":"Geographies"},"buyer_roles":{"type":"array","items":{"type":"string"},"description":"Buyer roles"},"user_roles":{"type":"array","items":{"type":"string"},"description":"User roles"},"use_cases":{"type":"array","items":{"type":"string"},"description":"Use cases"},"idempotency_key":{"type":"string","minLength":1,"maxLength":200,"description":"A unique string you make for this request, such as a UUID. Send the same key when you retry, and Debriefing returns the first answer instead of acting twice."}},"additionalProperties":false,"required":["idempotency_key"]},"outputSchema":{"type":"object","properties":{"ok":{"type":"boolean"},"message":{"type":"string"},"ideal_customer_profile":{"type":"object"},"daily_cap":{"type":"object"},"replayed":{"type":"boolean","description":"True when this answer repeats an earlier call with the same idempotency_key."}},"required":["ok","message"]},"annotations":{"title":"Update ideal customer profile","readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["spend"]}],"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["spend"]}],"openai/toolInvocation/invoking":"Updating the ideal customer profile","openai/toolInvocation/invoked":"Updated the ideal customer profile"}},{"name":"draft_positioning","title":"Draft positioning","description":"Reads the company's own website and drafts the empty positioning fields: value propositions, differentiators, and exclusions. Filled fields stay as they are. Read the result later with get_company_profile. Admin only. Counts toward a daily cap per workspace.","inputSchema":{"type":"object","properties":{"idempotency_key":{"type":"string","minLength":1,"maxLength":200,"description":"A unique string you make for this request, such as a UUID. Send the same key when you retry, and Debriefing returns the first answer instead of acting twice."}},"additionalProperties":false,"required":["idempotency_key"]},"outputSchema":{"type":"object","properties":{"ok":{"type":"boolean"},"message":{"type":"string"},"daily_cap":{"type":"object"},"replayed":{"type":"boolean","description":"True when this answer repeats an earlier call with the same idempotency_key."}},"required":["ok","message"]},"annotations":{"title":"Draft positioning","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"securitySchemes":[{"type":"oauth2","scopes":["spend"]}],"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["spend"]}],"openai/toolInvocation/invoking":"Drafting positioning","openai/toolInvocation/invoked":"Started the positioning draft"}},{"name":"get_delivery_settings","title":"Get delivery settings","description":"Gets how often Debriefing runs a monitoring cycle for the workspace, the cadences the plan allows, and whether a finished cycle goes out by email and to Slack. Admin only.","inputSchema":{"type":"object","properties":{},"additionalProperties":false},"outputSchema":{"type":"object","properties":{"monitoring_cadence":{"type":"object"},"delivery_channels":{"type":"object"},"url":{"type":"string"}},"required":["monitoring_cadence","delivery_channels"]},"annotations":{"title":"Get delivery settings","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["read"]}],"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["read"]}],"openai/toolInvocation/invoking":"Reading delivery settings","openai/toolInvocation/invoked":"Read delivery settings"}},{"name":"set_monitoring_cadence","title":"Set monitoring cadence","description":"Sets how often Debriefing runs a monitoring cycle. The plan decides which cadences are allowed; get_delivery_settings lists them. Admin only, on a paid plan.","inputSchema":{"type":"object","properties":{"cadence":{"type":"string","description":"A cadence from get_delivery_settings, such as weekly"}},"required":["cadence"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"ok":{"type":"boolean"},"message":{"type":"string"},"monitoring_cadence":{"type":"object"}},"required":["ok","message"]},"annotations":{"title":"Set monitoring cadence","readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["write"]}],"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["write"]}],"openai/toolInvocation/invoking":"Setting the cadence","openai/toolInvocation/invoked":"Set the cadence"}},{"name":"set_delivery_channels","title":"Set delivery channels","description":"Turns delivery of a finished cycle by email and to Slack on or off. Only the channels you send change. Slack needs a paid plan and a Slack connection made in the app. Admin only.","inputSchema":{"type":"object","properties":{"email":{"type":"boolean"},"slack":{"type":"boolean"}},"additionalProperties":false},"outputSchema":{"type":"object","properties":{"ok":{"type":"boolean"},"message":{"type":"string"},"delivery_channels":{"type":"object"}},"required":["ok","message"]},"annotations":{"title":"Set delivery channels","readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["write"]}],"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["write"]}],"openai/toolInvocation/invoking":"Setting delivery channels","openai/toolInvocation/invoked":"Set delivery channels"}},{"name":"create_share_link","title":"Create a public link to a signal","description":"Makes a public link to one signal that anyone with the address can open. A new link replaces the old one, which stops working. The plan sets how long a link can live; the free plan and Starter allow 24 hours.","inputSchema":{"type":"object","properties":{"signal_id":{"type":"integer","description":"An id from search_signals or what_changed"},"expiry":{"type":"string","enum":["never","24h","7d","30d","90d"],"default":"24h","description":"How long the link works. The free plan and Starter allow only 24h, and any other choice becomes 24h there."},"include_notes":{"type":"boolean","default":false,"description":"Show the team's talking points on the public page"},"idempotency_key":{"type":"string","minLength":1,"maxLength":200,"description":"A unique string you make for this request, such as a UUID. Send the same key when you retry, and Debriefing returns the first answer instead of acting twice."}},"required":["signal_id","idempotency_key"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"ok":{"type":"boolean"},"message":{"type":"string"},"share":{"type":"object"},"replayed":{"type":"boolean","description":"True when this answer repeats an earlier call with the same idempotency_key."}},"required":["ok","message"]},"annotations":{"title":"Create a public link to a signal","readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":true},"securitySchemes":[{"type":"oauth2","scopes":["write"]}],"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["write"]}],"openai/toolInvocation/invoking":"Creating the public link","openai/toolInvocation/invoked":"Created the public link"}},{"name":"list_members","title":"List members","description":"Lists the people in the workspace with their roles. An admin also sees pending invitations.","inputSchema":{"type":"object","properties":{},"additionalProperties":false},"outputSchema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object"}},"pending_invitations":{"type":"array","items":{"type":"object"}}},"required":["items"]},"annotations":{"title":"List members","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["read"]}],"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["read"]}],"openai/toolInvocation/invoking":"Reading members","openai/toolInvocation/invoked":"Read members"}},{"name":"invite_member","title":"Invite a teammate","description":"Sends an email invitation to join the workspace as a member. The invitation lasts 7 days. Inviting the same address again sends a fresh email. Admin only, on a paid plan.","inputSchema":{"type":"object","properties":{"email":{"type":"string","format":"email","maxLength":320},"idempotency_key":{"type":"string","minLength":1,"maxLength":200,"description":"A unique string you make for this request, such as a UUID. Send the same key when you retry, and Debriefing returns the first answer instead of acting twice."}},"required":["email","idempotency_key"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"ok":{"type":"boolean"},"message":{"type":"string"},"invitation":{"type":"object"},"replayed":{"type":"boolean","description":"True when this answer repeats an earlier call with the same idempotency_key."}},"required":["ok","message"]},"annotations":{"title":"Invite a teammate","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"securitySchemes":[{"type":"oauth2","scopes":["write"]}],"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["write"]}],"openai/toolInvocation/invoking":"Sending the invitation","openai/toolInvocation/invoked":"Sent the invitation"}},{"name":"what_changed","title":"What changed","description":"Lists everything new in the workspace since a time: signals Debriefing found, digests it wrote, and battlecards it wrote or rewrote. Use it to catch up, such as since the user's last visit.","inputSchema":{"type":"object","properties":{"since":{"type":"string","description":"ISO 8601 time, such as 2026-10-01T00:00:00Z"},"limit":{"type":"integer","minimum":1,"maximum":50,"description":"The most rows of each kind"}},"required":["since"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"since":{"type":"string"},"signals":{"type":"array","items":{"type":"object"}},"digests":{"type":"array","items":{"type":"object"}},"battlecards":{"type":"array","items":{"type":"object"}}},"required":["since","signals","digests","battlecards"]},"annotations":{"title":"What changed","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["read"]}],"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["read"]}],"openai/toolInvocation/invoking":"Reading what changed","openai/toolInvocation/invoked":"Read what changed"}},{"name":"search_public_briefs","title":"Search public briefs","description":"Searches the competitive briefs Debriefing publishes on debriefing.io about named companies, newest first. Each brief is dated and every finding cites a public source. Filter by words in the brief and by company name, slug, or domain. With no arguments, lists the newest briefs. Needs no Debriefing account. Returns the page URL of each brief.","inputSchema":{"type":"object","properties":{"query":{"type":"string","maxLength":200,"description":"Words to find in the brief, such as pricing or launch"},"company":{"type":"string","maxLength":200,"description":"A company name, slug, or domain, such as Crayon or crayon.co"},"limit":{"type":"integer","minimum":1,"maximum":50}},"additionalProperties":false},"outputSchema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"description":{"type":"string"},"company_name":{"type":"string"},"company_slug":{"type":"string"},"slug":{"type":"string"},"coverage_start_on":{"type":["string","null"]},"coverage_end_on":{"type":["string","null"]},"published_on":{"type":"string"},"updated_on":{"type":"string"},"finding_count":{"type":"integer"},"url":{"type":"string"}},"required":["title","company_name","company_slug","slug","url"]}},"briefs_url":{"type":"string"},"free_brief":{"type":"object","properties":{"url":{"type":"string"},"text":{"type":"string"}},"required":["url","text"]}},"required":["items","briefs_url","free_brief"]},"annotations":{"title":"Search public briefs","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"noauth"}],"_meta":{"securitySchemes":[{"type":"noauth"}],"openai/toolInvocation/invoking":"Searching public briefs","openai/toolInvocation/invoked":"Searched public briefs"}},{"name":"get_public_brief","title":"Get a public brief","description":"Gets one competitive brief that Debriefing published on debriefing.io: the summary, each finding with its category and date, and the numbered public sources with their URLs. Name the brief by its URL, or by company_slug and slug from search_public_briefs. With company_slug only, gets the newest brief about that company. Needs no Debriefing account.","inputSchema":{"type":"object","properties":{"url":{"type":"string","maxLength":500,"description":"The brief URL, such as https://debriefing.io/briefs/crayon/2026-09-28"},"company_slug":{"type":"string","maxLength":100,"description":"The company part of the brief URL, such as crayon"},"slug":{"type":"string","maxLength":100,"description":"The date part of the brief URL, such as 2026-09-28"}},"additionalProperties":false},"outputSchema":{"type":"object","properties":{"title":{"type":"string"},"description":{"type":"string"},"company":{"type":"object"},"coverage":{"type":"object"},"published_on":{"type":"string"},"updated_on":{"type":"string"},"summary":{"type":"array","items":{"type":"string"}},"findings":{"type":"array","items":{"type":"object"}},"sources":{"type":"array","items":{"type":"object"}},"url":{"type":"string"},"markdown_url":{"type":"string"},"free_brief":{"type":"object","properties":{"url":{"type":"string"},"text":{"type":"string"}},"required":["url","text"]}},"required":["title","company","summary","findings","sources","url","free_brief"]},"annotations":{"title":"Get a public brief","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"noauth"}],"_meta":{"securitySchemes":[{"type":"noauth"}],"openai/toolInvocation/invoking":"Reading the public brief","openai/toolInvocation/invoked":"Read the public brief"}},{"name":"search_guides","title":"Search CI guides","description":"Searches the public competitive intelligence library on debriefing.io: how-to guides, glossary terms, tool comparisons, alternatives pages, company profiles, and market intel posts. Returns the title, a short excerpt, and the page URL of each match, best match first. Needs no Debriefing account.","inputSchema":{"type":"object","properties":{"query":{"type":"string","minLength":1,"maxLength":200,"description":"Words to find, such as battlecard or win-loss interview"},"collection":{"type":"string","enum":["guides","intel","glossary","comparisons","alternatives","competitive-profiles"],"description":"Only search one part of the library"},"limit":{"type":"integer","minimum":1,"maximum":50}},"required":["query"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"description":{"type":"string"},"collection":{"type":"string"},"excerpt":{"type":"string"},"updated_on":{"type":"string"},"url":{"type":"string"}},"required":["title","collection","url"]}},"free_brief":{"type":"object","properties":{"url":{"type":"string"},"text":{"type":"string"}},"required":["url","text"]}},"required":["items","free_brief"]},"annotations":{"title":"Search CI guides","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"noauth"}],"_meta":{"securitySchemes":[{"type":"noauth"}],"openai/toolInvocation/invoking":"Searching the CI library","openai/toolInvocation/invoked":"Searched the CI library"}},{"name":"get_free_brief_link","title":"Get the free brief link","description":"Gets the debriefing.io links where a person requests a free competitive brief about their own company and competitors, signs up for a workspace, or compares plans. It only returns links. It sends nothing and creates nothing.","inputSchema":{"type":"object","properties":{},"additionalProperties":false},"outputSchema":{"type":"object","properties":{"free_brief_url":{"type":"string"},"sign_up_url":{"type":"string"},"pricing_url":{"type":"string"},"what_you_get":{"type":"string"},"connect_url":{"type":"string"}},"required":["free_brief_url","sign_up_url","pricing_url","what_you_get","connect_url"]},"annotations":{"title":"Get the free brief link","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"noauth"}],"_meta":{"securitySchemes":[{"type":"noauth"}],"openai/toolInvocation/invoking":"Getting the free brief link","openai/toolInvocation/invoked":"Got the free brief link"}}]}