MCP-Server

Cobalt Capture

com.cobaltcapture/cobalt
Design & Kreativ Marketing & Werbung Öffentlich und erreichbar MCP 2026-07-28

Was dieses MCP kann

Creates durable UX and product reviews with annotated screenshots, notes, research playbooks, published studies, and shareable reports.

add_note
Append a free-standing text note (not tied to a screenshot) to a review created by create_review. Use for context, steps taken, or a summary of findings between screenshots.
Externer Zugriff
Eingabeschema
{'type': 'object', 'required': ['review', 'claim_token', 'text'], 'properties': {'text': {'type': 'string', 'description': 'The note text (plain text or markdown).'}, 'review': {'type': 'string', 'description': 'The review slug or URL from create_review.'}, 'claim_token': {'type': 'string', 'description': 'The claim_token from create_review (authorizes the write). For a review the human has SAVED to their account, pass the agent token they generated on the review page (Export & more → Hand to your agent) here instead.'}}}
add_screenshot
Append one screenshot, with an optional title and note, to the end of a review. The image is stored in Cobalt and shown in the review. Three ways to supply it: `page_url`, a public page that Cobalt renders in a headless browser (`viewport` 'desktop' at 1280px or 'mobile' at 390px, `full_page` for the whole scroll, `hide_selectors` for elements to hide; common cookie banners are hidden automatically), which also returns the rendered image; `image_url`, an image already uploaded to https://cobaltcapture.com/api/upload; or `image`, a small base64 image. This tool only appends; it never changes an existing item (replace_screenshot does that).
Externer Zugriff
Eingabeschema
{'type': 'object', 'required': ['review', 'claim_token'], 'properties': {'image': {'type': 'string', 'description': 'A small base64-encoded PNG, JPEG or WebP (data: URL prefix accepted). Intended for images under about 100 KB; larger screenshots are better uploaded and passed as image_url.'}, 'title': {'type': 'string', 'description': 'Optional short caption for the screenshot.'}, 'review': {'type': 'string', 'description': 'The review slug or URL from create_review.'}, 'comment': {'type': 'string', 'description': "Optional note describing what this screen shows or what's wrong with it."}, 'page_url': {'type': 'string', 'description': "A public http(s) page for Cobalt to render and screenshot server-side. Pages behind a login can't be rendered. Becomes the item's source_url unless one is passed. Takes 10 to 30 seconds; a site that blocks automated browsers returns an error."}, 'viewport': {'enum': ['desktop', 'mobile'], 'type': 'string', 'description': "With page_url: 'desktop' (1280x800, default) or 'mobile' (390x844 phone, 2x, touch)."}, 'full_page': {'type': 'boolean', 'description': 'With page_url: capture the entire scrollable page instead of the first viewport. Default false. Pages that scroll inside an inner container come back viewport-sized.'}, 'image_url': {'type': 'string', 'description': "An image URL on Cobalt's own image host, as returned by https://cobaltcapture.com/api/upload (multipart field `file`, returns {url, key}) or by the editor's window.cobaltGrab(). External URLs are refused."}, 'source_url': {'type': 'string', 'description': 'Optional URL of the page the screenshot was taken on.'}, 'claim_token': {'type': 'string', 'description': 'The claim_token from create_review (authorizes the write). For a review the human has SAVED to their account, pass the agent token they generated on the review page (Export & more → Hand to your agent) here instead.'}, 'hide_selectors': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 10, 'description': "With page_url: extra CSS selectors to hide before the shot, e.g. ['#newsletter-modal', '.chat-widget']. Common cookie and consent banners are hidden on every render."}}}
check_inbox
Read mail delivered to an inbox from create_inbox, newest first, for example a verification code or confirmation link from a signup email. Returns immediately; mail usually arrives within seconds, so an empty result can be checked again shortly. format="html" returns each message's HTML for reviewing the email's design.
Nur Lesen Externer Zugriff
Eingabeschema
{'type': 'object', 'required': ['address', 'inbox_token'], 'properties': {'format': {'enum': ['text', 'html'], 'type': 'string', 'description': '"text" (default) returns each message flattened to readable text, with link targets kept. "html" returns the raw HTML part.'}, 'address': {'type': 'string', 'description': 'The inbox address from create_inbox.'}, 'inbox_token': {'type': 'string', 'description': 'The inbox_token from create_inbox (authorizes reading).'}}}
create_inbox
Create a temporary email inbox for signing up to a product under test. Returns an `address` to enter in the signup form and an `inbox_token` for reading it with check_inbox. Inboxes expire after a day.
Externer Zugriff
Eingabeschema
{'type': 'object', 'properties': {'review': {'type': 'string', 'description': 'Optional review slug this inbox belongs to — a label for your own bookkeeping.'}}}
create_review
Start a new Cobalt Capture review and get a handle for filling it in. Use this to compile the findings of any site study — a usability pass, a pricing teardown, a positioning audit, a QA run — into one shareable, durable report with real screenshots. Works from any client, chat assistants included: with no browser, add_screenshot(page_url=...) renders the pages for you. Returns a `review` slug and a `claim_token` — pass BOTH back to add_screenshot / add_note to append content. Also returns a `review_url` to share and a `save_url` the human opens (while signed in) to save the review to their account permanently. The review is anonymous and auto-deletes after 30 days unless saved.
Externer Zugriff
Eingabeschema
{'type': 'object', 'required': ['title'], 'properties': {'title': {'type': 'string', 'description': "Title of the review, e.g. 'Onboarding walkthrough — Jupiter Invoice'."}, 'summary': {'type': 'string', 'description': 'Optional overview shown at the top of the review (plain text or markdown). Good place for the overall task, outcome, and headline findings.'}, 'product_url': {'type': 'string', 'description': 'Optional URL of the product/site under review.'}}}
email_review
Email a link to a review to the person who ran the study. Sends only to an address that belongs to a verified Cobalt account (other addresses are refused, which keeps the tool from being used to send unsolicited mail). The email contains only the review link, never text supplied in the call.
Destruktiv Externer Zugriff
Eingabeschema
{'type': 'object', 'required': ['review', 'claim_token', 'email'], 'properties': {'email': {'type': 'string', 'description': "The human's Cobalt account email. Must belong to a verified account, or the send is refused."}, 'review': {'type': 'string', 'description': 'The review slug or URL from create_review.'}, 'claim_token': {'type': 'string', 'description': 'The claim_token from create_review (proves you created this review), or, for a saved review, the agent token its owner generated on the review page (Export & more → Hand to your agent).'}}}
fetch
Fetch the full text of a Cobalt study by the id search returned, or of any Cobalt review by its URL (/r/<slug>) or slug. Returns text: findings, prices, the comparison matrix, and the underlying review's notes with links to its screenshots. Use get_review instead when you need to see the screenshots as images.
Nur Lesen
Eingabeschema
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': "An id from search (e.g. 'teardown:canva'), or a review URL or slug."}}}
get_playbook
Return the full text of a Cobalt study playbook: a step-by-step method for a kind of product review that ends in a shareable Cobalt review. Available: 'pricing_teardown' (can a buyer tell what they would pay and which tier fits; public pages only); 'website_teardown' (what each key page leads with and says, judged as a first-time visitor; public pages only; 'positioning_pass' is its old name); 'comparison_study' (two or three products compared for one buying decision, with a sourced matrix; public pages plus web search); 'usability_pass' (a first-time-user audit that signs up and uses the product; needs a browser); 'flow_pass' (one named flow such as signup or checkout, including its emails; needs a browser); 'investigation_pass' (a product investigation of an app the user owns, run in its own environment; needs a browser and usually the code). The public-page studies work without a browser because add_screenshot(page_url) renders pages server-side.
Nur Lesen
Eingabeschema
{'type': 'object', 'required': ['name'], 'properties': {'url': {'type': 'string', 'description': 'The site to run it against, if you already know it.'}, 'name': {'type': 'string', 'description': "Playbook name, e.g. 'usability_pass'."}}}
get_review
Fetch a Cobalt Capture review by its share link or slug. Returns the reviewer's notes as text AND each annotated screenshot as an image, so you can see exactly what was marked and what to change.
Nur Lesen
Eingabeschema
{'type': 'object', 'required': ['review'], 'properties': {'review': {'type': 'string', 'description': 'A Cobalt review URL (https://cobaltcapture.com/r/<slug> or /s/<slug>) or just the slug.'}}}
replace_screenshot
Overwrite one existing screenshot in a review with a new capture, in the same position. Destructive: the old image and any pins or annotations on it are removed and cannot be recovered; the title and comment change only if new ones are passed. Works on screenshots only, not notes. Takes the same capture arguments as add_screenshot, plus `item`, the 1-based number of the screenshot to replace.
Destruktiv Externer Zugriff
Eingabeschema
{'type': 'object', 'required': ['review', 'claim_token', 'item'], 'properties': {'item': {'type': 'integer', 'minimum': 1, 'description': 'The 1-based number of the existing screenshot item to overwrite (as it appears in the review, counting notes).'}, 'image': {'type': 'string', 'description': 'A small base64-encoded PNG, JPEG or WebP (data: URL prefix accepted). Intended for images under about 100 KB; larger screenshots are better uploaded and passed as image_url.'}, 'title': {'type': 'string', 'description': 'Optional short caption for the screenshot.'}, 'review': {'type': 'string', 'description': 'The review slug or URL from create_review.'}, 'comment': {'type': 'string', 'description': "Optional note describing what this screen shows or what's wrong with it."}, 'page_url': {'type': 'string', 'description': "A public http(s) page for Cobalt to render and screenshot server-side. Pages behind a login can't be rendered. Becomes the item's source_url unless one is passed. Takes 10 to 30 seconds; a site that blocks automated browsers returns an error."}, 'viewport': {'enum': ['desktop', 'mobile'], 'type': 'string', 'description': "With page_url: 'desktop' (1280x800, default) or 'mobile' (390x844 phone, 2x, touch)."}, 'full_page': {'type': 'boolean', 'description': 'With page_url: capture the entire scrollable page instead of the first viewport. Default false. Pages that scroll inside an inner container come back viewport-sized.'}, 'image_url': {'type': 'string', 'description': "An image URL on Cobalt's own image host, as returned by https://cobaltcapture.com/api/upload (multipart field `file`, returns {url, key}) or by the editor's window.cobaltGrab(). External URLs are refused."}, 'source_url': {'type': 'string', 'description': 'Optional URL of the page the screenshot was taken on.'}, 'claim_token': {'type': 'string', 'description': 'The claim_token from create_review (authorizes the write). For a review the human has SAVED to their account, pass the agent token they generated on the review page (Export & more → Hand to your agent) here instead.'}, 'hide_selectors': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 10, 'description': "With page_url: extra CSS selectors to hide before the shot, e.g. ['#newsletter-modal', '.chat-widget']. Common cookie and consent banners are hidden on every render."}}}
search
Search the studies Cobalt Capture has published on well-known products: pricing teardowns, positioning audits, and head-to-head comparisons (for example Canva pricing, Spotify vs Apple Music). Returns matching studies as {id, title, url}; pass an id to fetch for the full text. It does NOT search private reviews, which are reachable only by their link (use get_review, or fetch with the review URL).
Nur Lesen
Eingabeschema
{'type': 'object', 'required': ['query'], 'properties': {'query': {'type': 'string', 'description': "What to look for, e.g. 'canva pricing' or 'spotify'."}}}
update_review
Set or replace a review's summary and/or title. The summary is shown at the top of the review, above every screenshot and note. Replaces any existing summary or title.
Destruktiv Externer Zugriff Idempotent
Eingabeschema
{'type': 'object', 'required': ['review', 'claim_token'], 'properties': {'title': {'type': 'string', 'description': 'Optional replacement title.'}, 'review': {'type': 'string', 'description': 'The review slug or URL from create_review.'}, 'summary': {'type': 'string', 'description': 'The overview shown at the top of the review. Replaces any existing summary.'}, 'claim_token': {'type': 'string', 'description': 'The claim_token from create_review (authorizes the write). For a review the human has SAVED to their account, pass the agent token they generated on the review page (Export & more → Hand to your agent) here instead.'}, 'compared_to': {'type': 'string', 'description': "Optional: when this run repeats an earlier study, the earlier review's slug or URL. Recorded so re-runs can be compared over time."}}}
Geändert
email_review
3. October 2026 03:00
Geändert
check_inbox
3. October 2026 03:00
Geändert
create_inbox
3. October 2026 03:00
Geändert
fetch
3. October 2026 03:00
Geändert
search
3. October 2026 03:00
Geändert
get_playbook
3. October 2026 03:00
Geändert
update_review
3. October 2026 03:00
Geändert
add_note
3. October 2026 03:00
Geändert
replace_screenshot
3. October 2026 03:00
Geändert
add_screenshot
3. October 2026 03:00
Geändert
create_review
3. October 2026 03:00
Geändert
get_review
3. October 2026 03:00
Geändert
get_playbook
25. September 2026 03:01
Geändert
update_review
25. September 2026 03:01
Hinzugefügt
replace_screenshot
25. September 2026 03:01
Geändert
add_screenshot
25. September 2026 03:01
Hinzugefügt
email_review
17. September 2026 12:34
Hinzugefügt
check_inbox
17. September 2026 12:34
Hinzugefügt
create_inbox
17. September 2026 12:34
Hinzugefügt
fetch
17. September 2026 12:34
Hinzugefügt
search
17. September 2026 12:34
Hinzugefügt
get_playbook
17. September 2026 12:34
Hinzugefügt
update_review
17. September 2026 12:34
Hinzugefügt
add_note
17. September 2026 12:34
Hinzugefügt
add_screenshot
17. September 2026 12:34
Hinzugefügt
create_review
17. September 2026 12:34
Hinzugefügt
get_review
17. September 2026 12:34