Yellowhead Digital MCP
A live Model Context Protocol server that provides an authenticated, org-scoped, and capability-bound interface for AI agents to interact with Yellowhead Digital workspaces. It allows agents to read marketing diagnostics, reports, and plan usage, and on team accounts, create workspaces or start diagnostics, with all writes held for human approval by default.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
https://api.yellowhead.digital/mcpWhat its tools do
21 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.
Read-only (20)
list_diagnosticsget_diagnosticget_reportlist_action_itemsget_action_itemget_usagelist_strategic_assessmentsget_strategic_assessmentlist_infrastructure_auditsget_infrastructure_auditlist_citation_scansget_citation_scanlist_crawlability_scansget_crawlability_scanlist_accessibility_scansget_accessibility_scandescribe_yellowheadlist_portfolioget_portfolio_changesget_run_status
Can change data (1)
Checks and signals
Each line is separate evidence, not a trust score.
- Passed Endpoint answered the live check ·
- Passed Official MCP Registry namespace is tied to yellowhead.digital ·
- Passed Endpoint is on the registry namespace domain ·
- Availability 1 of 1 checks passed in 30 days
What you can do with it
- Read marketing diagnostics and reports
- Start a new marketing diagnostic
- Create a prospect or client workspace
- Check account plan usage
Source and maintenance
Protocol and capabilities
- Server
- yellowhead-agent-door 0.1.0
- MCP protocol negotiated in check
- 2025-11-25
- Tools
- 21 advertised
- Resources
- Not advertised
- Resource templates
- Not advertised
- Prompts
- Not advertised
{
"tools": {
"listChanged": false
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
21 advertised
list_diagnostics — List Diagnostics
Lists the Diagnostics in the connected Yellowhead account, newest first. Each item has its id, business name, website, status (queued, processing, completed or failed; a run with no result after 15 minutes is reported as failed), client_id, MIDAS score once complete, and created date. Diagnostics are visible across the whole account, not only to the person who ran them. Filters: client_id (one client workspace) and since (created on or after a date and time). An empty page means none were returned for these filters, not that none exist. Fits questions like "what Diagnostics do we have" and "is my Diagnostic ready", and finding two runs to compare.
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Page size (default 25, max 100)."
},
"since": {
"type": "string",
"format": "date-time",
"description": "Only diagnostics created at/after this RFC 3339 timestamp."
},
"cursor": {
"type": "string",
"description": "Opaque pagination cursor from a previous list response."
},
"client_id": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
}{
"title": "List Diagnostics",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_diagnostic — Get a Diagnostic
Returns one Diagnostic by id: its status, business name, website, client_id, MIDAS score and created date, plus report_id once it has completed. Fits checking whether a particular run has finished; the findings themselves come from get_report.
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
}{
"title": "Get a Diagnostic",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_report — Get a Diagnostic report
Returns the report of a completed Diagnostic by id: the ten pillar scores as the person rated them (side_a_scores) and as detected (side_b_scores), the MIDAS score, executive summary, blind spots, budget and investment reads, business profile, detected tech stack, brand visibility and sentiment, published apps, and a counts-only summary of the AI connectors found. Internal signals are not included. Some detail depends on the account's plan, as the app shows it: on the Free plan the report carries one blind spot (with that pillar's sub-scores only), the brand visibility and sentiment scores without their findings, the stated and estimated tool spend (on older reports, the estimated total) without the per-pillar breakdown, and no market context; the advertising sub-scores also need Starter or above; the investment roadmap (recommended_investment) and published-app identifiers and links need Pro or above (below Pro, published_apps lists only the platforms). A Diagnostic that has not finished returns report_not_ready. Scores for an unchanged site can move a little between runs, so a small change is not on its own evidence that something changed. The findings are what can be observed from outside.
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
}{
"title": "Get a Diagnostic report",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}list_action_items — List action items
Lists the action items in the connected account, newest first. Each has its id, title, description, rationale, status, priority, pillar, phase, estimated cost range, suggested tools, remediation guidance, the source it came from (source_type and source_id: a Diagnostic, which get_report reads, or a Citation, Crawlability or Accessibility Scan, which get_citation_scan, get_crawlability_scan or get_accessibility_scan reads), client_id, assignee and due date. Statuses: suggested, queued, in_progress, completed (the person doing it says it is done), confirmed (a second person signed off), verified (a later Diagnostic saw the fix from outside) and dismissed. Filters: client_id, source_id and status. An empty page means none were returned for these filters. Fits "what should we fix first" and progress reviews. Changes to an action item are made in the Yellowhead app, or through a connection an account admin set up there.
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Page size (default 25, max 100)."
},
"cursor": {
"type": "string",
"description": "Opaque pagination cursor from a previous list response."
},
"status": {
"enum": [
"suggested",
"queued",
"in_progress",
"completed",
"confirmed",
"verified",
"dismissed"
],
"type": "string"
},
"client_id": {
"type": "string",
"format": "uuid"
},
"source_id": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
}{
"title": "List action items",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_action_item — Get an action item
Returns one action item by id with its full detail: why it matters (rationale), what to do (description and remediation guidance), the tools involved, its status and dates, and the source it came from (source_type and source_id: a Diagnostic, or a Citation, Crawlability or Accessibility Scan). Fits explaining or planning one fix. Fixes happen on the business's own systems with its own access; an item becomes verified only when a later Diagnostic sees the fix from outside. Changes to an action item are made in the Yellowhead app, or through a connection an account admin set up there.
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
}{
"title": "Get an action item",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_usage — Get Diagnostic usage
Returns this month's Diagnostic allowance for the connected account: how many included Diagnostics are used (used), the monthly allowance (limit), how many remain (remaining), the plan, whose allowance a run draws on (pool), and the date the allowance resets (resets_on). On the Free plan it carries a note on the first-month allowance. With client_id, it also gives that client workspace's own monthly limit (per_client). Fits questions about how many Diagnostics are left this month and when the allowance resets.
{
"type": "object",
"properties": {
"client_id": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
}{
"title": "Get Diagnostic usage",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}list_strategic_assessments — List Strategic Assessments
Lists the published Strategic Assessments in the connected account, newest first, with their ids, the Diagnostic each was based on, client_id and dates. Only published assessments appear: one that is booked or still being written appears once it is published, so an empty page does not mean none was ordered. Filters: client_id and diagnostic_report_id. A Strategic Assessment is a written walkthrough of a Diagnostic's findings, prepared with the business: which matter and what to fix first.
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Page size (default 25, max 100)."
},
"cursor": {
"type": "string",
"description": "Opaque pagination cursor from a previous list response."
},
"client_id": {
"type": "string",
"format": "uuid"
},
"diagnostic_report_id": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
}{
"title": "List Strategic Assessments",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_strategic_assessment — Get a Strategic Assessment
Returns one published Strategic Assessment by id: the deliverable written for the business after its live session. Fits working from its priorities and recommendations.
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
}{
"title": "Get a Strategic Assessment",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}list_infrastructure_audits — List Infrastructure Audits
Lists the published Infrastructure Audits in the connected account, newest first, with their ids, the Diagnostic each followed, client_id and dates. Only published audits appear: one that is in progress appears once it is published. Filters: client_id and diagnostic_report_id.
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Page size (default 25, max 100)."
},
"cursor": {
"type": "string",
"description": "Opaque pagination cursor from a previous list response."
},
"client_id": {
"type": "string",
"format": "uuid"
},
"diagnostic_report_id": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
}{
"title": "List Infrastructure Audits",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_infrastructure_audit — Get an Infrastructure Audit
Returns one published Infrastructure Audit by id, as published to the account. Fits working from its findings and recommendations.
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
}{
"title": "Get an Infrastructure Audit",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}list_citation_scans — List Citation Scans
Lists the Citation Scans in the connected account, newest first. A Citation Scan asks a fixed set of buyer questions in one category and country across several AI answer engines and records which websites the answers cite. Each item has its id, the website scanned (target_domain), category, country, status (pending_payment, paid, running, completed, failed or cancelled), client_id, the Diagnostic it started from (diagnostic_report_id), created and completed dates, and once completed the share of answered cells that cited the website (target_share, 0 to 1) and how many answer cells were filled (populated_cells). Filters: client_id and status. An empty page means none were returned for these filters, not that the account has none or that Yellowhead does not offer the scan.
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Page size (default 25, max 100)."
},
"cursor": {
"type": "string",
"description": "Opaque pagination cursor from a previous list response."
},
"status": {
"enum": [
"pending_payment",
"paid",
"running",
"completed",
"failed",
"cancelled"
],
"type": "string"
},
"client_id": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
}{
"title": "List Citation Scans",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_citation_scan — Get a Citation Scan
Returns one Citation Scan by id: its website, category, country, status and dates, the named competitors (competitor_domains), and once completed its results: the ranking of every domain the answers cited with each one's share of answered cells, the coverage (how many answer cells were filled), each answer cell's question, engine, whether the scanned website was cited and which domains were, and where the scan asked them, the head-to-head questions against named competitors. results is null until the scan completes; on a completed scan whose stored results could not be read, results_unavailable is true and the results are in the Yellowhead app. The citations are what the engines answered when asked; they can differ between runs and are not on their own evidence of why a site was or was not cited. The cited page addresses are in the Yellowhead app.
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
}{
"title": "Get a Citation Scan",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}list_crawlability_scans — List Crawlability Scans
Lists the Crawlability Scans in the connected account, newest first. A Crawlability Scan checks, URL by URL from the website's sitemap, whether AI crawlers are allowed in by robots.txt and whether pages answer AI crawler identities the way they answer a browser. Each item has its id, the website (target_domain), status (draft, importing, awaiting_review, pending_payment, paid, running, completed, failed or cancelled; the first three are the free sitemap import and page review), whether it is a re-scan of an earlier scan's pages (sample_mode same_as_prior) or a first scan (fresh), the approved and measured page counts, client_id, diagnostic_report_id, and created and completed dates. Filters: client_id and status. An empty page means none were returned for these filters, not that the account has none or that Yellowhead does not offer the scan.
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Page size (default 25, max 100)."
},
"cursor": {
"type": "string",
"description": "Opaque pagination cursor from a previous list response."
},
"status": {
"enum": [
"draft",
"importing",
"awaiting_review",
"pending_payment",
"paid",
"running",
"completed",
"failed",
"cancelled"
],
"type": "string"
},
"client_id": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
}{
"title": "List Crawlability Scans",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_crawlability_scan — Get a Crawlability Scan
Returns one Crawlability Scan by id: its website, sitemap, status, dates and page counts (imported, approved, measured, not measured, dead, stale or missing last-modified dates, duplicates, linked but not in the sitemap), and once completed its run summary (results): whether robots.txt and llms.txt were read, the per-crawler roll-up of what robots.txt allows, how pages answered AI crawler identities compared with a browser, pages linked from the site that the sitemap does not list (up to 25 of each list, with the totals), and why a run stopped early if it did. results is null until the scan completes; on a completed scan whose stored results could not be read, results_unavailable is true and the results are in the Yellowhead app. A robots.txt that could not be read is reported as unknown, not as absent. The per-URL results are in the Yellowhead app.
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
}{
"title": "Get a Crawlability Scan",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}list_accessibility_scans — List Accessibility Scans
Lists the Accessibility Scans in the connected account, newest first. An Accessibility Scan measures a sample of the website's pages against automated WCAG 2.x A and AA checks, grouped by page template. Each item has its id, the website (target_domain), status (draft, importing, awaiting_review, pending_payment, paid, running, completed, failed or cancelled; the first three are the free sitemap import and page review), whether it is a re-scan of an earlier scan's pages (sample_mode same_as_prior) or a first scan (fresh), the approved and measured page counts, the number of page templates, client_id, diagnostic_report_id, and created and completed dates. Filters: client_id and status. An empty page means none were returned for these filters, not that the account has none or that Yellowhead does not offer the scan.
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Page size (default 25, max 100)."
},
"cursor": {
"type": "string",
"description": "Opaque pagination cursor from a previous list response."
},
"status": {
"enum": [
"draft",
"importing",
"awaiting_review",
"pending_payment",
"paid",
"running",
"completed",
"failed",
"cancelled"
],
"type": "string"
},
"client_id": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
}{
"title": "List Accessibility Scans",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_accessibility_scan — Get an Accessibility Scan
Returns one Accessibility Scan by id: its website, sitemap, status, dates and page counts, and once completed its results: the run summary (pages measured on both viewports, templates sampled, and the note on what automated checks can and cannot show), the per-template roll-up of failing checks (the 20 largest templates and up to 25 of the most widespread failing checks each, with the totals), and on a re-scan the fix verification against the earlier scan as counts (fixed, still failing or not confirmed). results is null until the scan completes; on a completed scan whose stored results could not be read, results_unavailable is true and the results are in the Yellowhead app. Automated checks cover only part of WCAG, so a page with no failing check is not thereby shown to meet it. The per-page results are in the Yellowhead app.
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
}{
"title": "Get an Accessibility Scan",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}describe_yellowhead — About Yellowhead and the free Diagnostic
Describes Yellowhead Digital, with no sign-in needed: what it is; the free Diagnostic (the ten pillars it checks, how long it takes, what the Free plan includes, and that an account is needed to run one); every plan with its price and monthly Diagnostics; the paid scans and human services with their prices and public pages; and a link that opens the Diagnostic form with a website and business name filled in. Fits questions about what Yellowhead does or costs, whether it checks something, or how to get started, including before any account exists. The optional url and business_name only fill in that link: nothing is scanned, stored or looked up.
{
"type": "object",
"properties": {
"url": {
"type": "string",
"maxLength": 2048,
"description": "Optional. The website to prefill in the start link, as the person gave it."
},
"business_name": {
"type": "string",
"maxLength": 200,
"description": "Optional. The business name to prefill in the start link, as the person gave it."
}
},
"additionalProperties": false
}{
"title": "About Yellowhead and the free Diagnostic",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}list_portfolio — List the Portfolio
Lists the client workspaces of the connected team account (brand workspaces on Business Enterprise), one page at a time, with the total so an answer can say how many are shown out of how many. Each row has the client_id, client name and website, the latest Diagnostic (report_id and date; it may still be running or may have failed) and the days since it, the MIDAS score with its tier, its change from the previous scored Diagnostic and whether that change is larger than the usual run-to-run variation, open_action_items (the Portfolio page's own count: items not done and not dismissed, so suggested, queued and in progress), open_high_priority_items (the open items that are critical or high), and the next scheduled Diagnostic. Both item counts cover only work the account owes: items from Diagnostics classified as a competitor, research or a prospect are not counted (list_action_items still lists them). Sorts: name, largest_decline, largest_improvement, lowest_midas, most_open_high_priority, most_open_items, longest_since_last_diagnostic, most_recent_diagnostic and next_scheduled; in the score and date sorts, a client with no Diagnostic or no score comes last. Filters: search (name or website), status, MIDAS tier, client_id, pillar (counts only that pillar's critical and high items) and min_open_high_priority_items. An empty page means no workspace matched these filters, not that the account has none. Included with team accounts on the Agency plans, Business Enterprise and custom plans. Fits "which clients need attention", ranking clients, and finding a client's client_id by name for list_action_items or list_diagnostics.
{
"type": "object",
"properties": {
"sort": {
"enum": [
"name",
"largest_decline",
"largest_improvement",
"lowest_midas",
"most_open_items",
"longest_since_last_diagnostic",
"most_recent_diagnostic",
"next_scheduled",
"most_open_high_priority"
],
"type": "string",
"description": "Row order (default name)."
},
"tier": {
"enum": [
"critical",
"exposed",
"operational",
"strong",
"exceptional",
"unscored"
],
"type": "string",
"description": "Only workspaces whose latest MIDAS score is in this tier, or that have no score yet."
},
"limit": {
"type": "integer",
"maximum": 25,
"minimum": 1,
"description": "Page size (default 10, max 25)."
},
"cursor": {
"type": "string",
"description": "Opaque pagination cursor (next_cursor) from a previous response."
},
"pillar": {
"enum": [
"attribution",
"tech_stack",
"conversion",
"compliance",
"brand",
"marketing",
"advertising",
"competitors",
"product",
"discoverability"
],
"type": "string",
"description": "A pillar (compliance is shown to people as Trust & Security). The critical and high item count, and min_open_high_priority_items, then cover that pillar only."
},
"search": {
"type": "string",
"maxLength": 100,
"description": "Part of a client name or website, matched without regard to case."
},
"status": {
"enum": [
"active",
"archived",
"all"
],
"type": "string",
"description": "Active workspaces (default), archived ones, or all."
},
"client_id": {
"type": "string",
"format": "uuid",
"description": "One client workspace's row."
},
"min_open_high_priority_items": {
"type": "integer",
"maximum": 10000,
"minimum": 1,
"description": "Only workspaces with at least this many open items of critical or high priority, counting only work the account owes."
}
},
"additionalProperties": false
}{
"title": "List the Portfolio",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_portfolio_changes — Get Portfolio changes
Lists the client workspaces whose MIDAS score moved since a date (default: the last 30 days), largest move first. A client appears when its most recent scored Diagnostic is on or after that date and its MIDAS changed, against the scored Diagnostic before it, by more than the usual run-to-run variation; smaller moves are left out, because scores for an unchanged site can move a little between runs. Each item has the client_id and client name, the previous and current MIDAS and the change, both report_ids with their dates for citing (report_id, previous_report_id and previous_report_date are null when that pair cannot be confirmed in this account), and the open items of critical or high priority (only work the account owes: items from Diagnostics classified as a competitor, research or a prospect are not counted). direction narrows the list to declines or improvements; client_id narrows it to one client. An empty list means no client moved by more than that in the window, not that nothing changed. truncated is true when more clients moved by more than that in the window than one call examines (the most recent are examined), so the list may be incomplete. Archived workspaces are not included. Included with team accounts on the Agency plans, Business Enterprise and custom plans. Fits "which of my clients got worse this month" and "who improved since our last review".
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"maximum": 25,
"minimum": 1,
"description": "Page size (default 10, max 25)."
},
"since": {
"type": "string",
"description": "Start of the window: a date (YYYY-MM-DD, read as midnight UTC) or an RFC 3339 date-time. Default: 30 days ago."
},
"cursor": {
"type": "string",
"description": "Opaque pagination cursor (next_cursor) from a previous response."
},
"client_id": {
"type": "string",
"format": "uuid",
"description": "One client workspace only."
},
"direction": {
"enum": [
"declined",
"improved",
"any"
],
"type": "string",
"description": "declined, improved, or any (default)."
}
},
"additionalProperties": false
}{
"title": "Get Portfolio changes",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}start_diagnostic — Start a free Diagnostic
Starts a Diagnostic of a website for the signed-in person, in two calls. The first call returns a preview and starts nothing: the website, the business name, the ten 1-to-10 self-ratings (which were answered, carried over or entered as 5 for "not sure"), the monthly tools budget, where the run is filed, which of the account's included monthly Diagnostics it uses, and a confirmation_token. A second call with that token starts it; any change needs a new preview. It uses only the account's included Diagnostics: when none are left the result is quota_exhausted with the reset date and the plans page, and nothing is charged. A run takes 5 to 10 minutes and a completion email also arrives; get_run_status reports progress. earlier_report_id fills in the website, name, ratings and budget from an earlier report, for a re-check; if that run did not complete and the same person started it, starting it again once for the same website and name does not use another Diagnostic (the preview says whether it applies). On an account with workspaces (clients, prospects or brands), client_id or file_as says where the run is filed, and needs_client lists the candidates when that is not clear. For an owner or admin of an Agency-plan team account, file_as prospect on a website not yet in Prospects creates a new prospect workspace for it (named by prospect_name, else the business name); the preview says so and nothing is created before the confirmation. The same person may ask for a new client workspace for a website no workspace holds: file_as client with client_name (the new workspace's name); without client_name a miss lists the client workspaces instead. Available on connections made through an AI assistant's sign-in.
{
"type": "object",
"properties": {
"url": {
"type": "string",
"maxLength": 8192,
"description": "The website to check, as the person gave it (a domain or an http/https address). Tracking parameters are removed, and the address that remains must be at most 2048 characters. Optional with earlier_report_id."
},
"budget": {
"type": [
"integer",
"null"
],
"maximum": 100000000,
"minimum": 0,
"description": "Roughly what the business spends a month on marketing tools and software, in whole US dollars. Null when unknown: it is then entered as 0, the intake form's own default. Left out, it is also entered as 0, except with earlier_report_id, where the earlier report's budget is carried over."
},
"file_as": {
"enum": [
"client",
"prospect",
"own"
],
"type": "string",
"description": "What the person asked for when no client_id is sent: prospect (filed in Prospects; for an owner or admin of an Agency-plan team account, a website not yet in Prospects gets a new prospect workspace), client (with client_name, the same person may have a new client workspace created for a website no workspace holds), or own (the account's own website or one of its brands: filed in the brand's workspace when the site matches one, else in no workspace; recorded as the account's own business). A run in no workspace without own is recorded as research on another business; the preview says which."
},
"client_id": {
"type": "string",
"format": "uuid",
"description": "The client, prospect or brand workspace to file the run in. It must be a workspace of this account."
},
"client_name": {
"type": "string",
"maxLength": 120,
"description": "Asks for a new client workspace with this name, for a website no workspace of the account holds. Sent only with file_as client and without client_id, and only when the person asked for a new client workspace; for an owner or admin of an Agency-plan team account. Invisible and control characters are removed; it needs a letter or digit."
},
"business_name": {
"type": "string",
"maxLength": 200,
"description": "The name of the business that operates the website, as the person gave it. Optional with earlier_report_id."
},
"prospect_name": {
"type": "string",
"maxLength": 120,
"description": "The name of a new prospect workspace, sent only with file_as prospect and without client_id. Left out, the business name is used. Invisible and control characters are removed; it needs a letter or digit."
},
"side_a_scores": {
"type": "object",
"properties": {
"brand": {
"type": "integer",
"maximum": 10,
"minimum": 1
},
"product": {
"type": "integer",
"maximum": 10,
"minimum": 1
},
"marketing": {
"type": "integer",
"maximum": 10,
"minimum": 1
},
"compliance": {
"type": "integer",
"maximum": 10,
"minimum": 1
},
"conversion": {
"type": "integer",
"maximum": 10,
"minimum": 1
},
"tech_stack": {
"type": "integer",
"maximum": 10,
"minimum": 1
},
"advertising": {
"type": "integer",
"maximum": 10,
"minimum": 1
},
"attribution": {
"type": "integer",
"maximum": 10,
"minimum": 1
},
"competitors": {
"type": "integer",
"maximum": 10,
"minimum": 1
},
"discoverability": {
"type": "integer",
"maximum": 10,
"minimum": 1
}
},
"description": "The person's own 1-to-10 rating of each pillar, keyed attribution, tech_stack, conversion, compliance (shown to people as Trust & Security), brand, marketing, advertising, competitors, product and discoverability. A pillar left out is \"not sure\" and is entered as 5, the intake form's own default.",
"additionalProperties": false
},
"earlier_report_id": {
"type": "string",
"format": "uuid",
"description": "An earlier Diagnostic of this account whose website, business name, ratings and budget fill in anything not sent."
},
"confirmation_token": {
"type": "string",
"description": "The token from this tool's preview. Present only on the second call, which starts the run."
}
},
"additionalProperties": false
}{
"title": "Start a free Diagnostic",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}get_run_status — Get a Diagnostic run's status
Reports whether a Diagnostic is queued, running, completed or failed, by its id (diagnostic_id, as start_diagnostic and list_diagnostics give it), with when it started and how many minutes have passed. A Diagnostic usually takes 5 to 10 minutes; one taking longer is reported as running with slow set, because it may still finish, and as failed only once it has recorded a failure or 30 minutes have passed. A failed result says whether starting it again from this connection uses another of the month's Diagnostics. Fits "is it ready yet?" at any point in the conversation.
{
"type": "object",
"required": [
"diagnostic_id"
],
"properties": {
"diagnostic_id": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
}{
"title": "Get a Diagnostic run's status",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}Prompts
Not advertised
Resources
Not advertised
90-day uptime
A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.
- 2026-11-09: 1 of 1 checks answered
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 956 ms
- 95th percentile latency
- 956 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 956 ms · metadata changed · 21 tool(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
claude mcp add --transport http yellowhead-digital-mcp https://api.yellowhead.digital/mcpCodex
codex mcp add yellowhead-digital-mcp --url https://api.yellowhead.digital/mcpCursor
{
"mcpServers": {
"yellowhead-digital-mcp": {
"url": "https://api.yellowhead.digital/mcp"
}
}
}Cline
{
"mcpServers": {
"yellowhead-digital-mcp": {
"type": "streamableHttp",
"url": "https://api.yellowhead.digital/mcp",
"disabled": false
}
}
}VS Code
{
"servers": {
"yellowhead-digital-mcp": {
"type": "http",
"url": "https://api.yellowhead.digital/mcp"
}
}
}Gemini CLI
gemini mcp add --transport http yellowhead-digital-mcp https://api.yellowhead.digital/mcpClaude Desktop
https://api.yellowhead.digital/mcpWindsurf
{
"mcpServers": {
"yellowhead-digital-mcp": {
"serverUrl": "https://api.yellowhead.digital/mcp"
}
}
}Let your agent find its tools
Find servers like Yellowhead Digital MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.
Other crm, sales, and marketing servers
Do you run Yellowhead Digital MCP?
Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.