Copilot Studio Friction Index

Official7 tools

by AdrianStauffer

Evidence-based register of known Copilot Studio errors and limits, with dated, human-verified fixes.

Captured live from the server via tools/list.

search_frictions

Ranked search over the Copilot Studio Friction Index. Exact error-code/message hits rank first, then title, alias, summary and symptom-checklist matches (solution bodies are NOT searched — an empty result means no record is indexed under these terms, not that the register lacks a fix). Use this when the user describes a Copilot Studio problem, symptom or keyword. Returns compact records with slug, status, severity, last-verified date and the citable powerleap.ch URL.

Parameters4

query	string	required	Error string, symptom or keywords, e.g. "flow times out after 100 seconds".
category	string	optional	Optional category filter.
status	string	optional	Optional status filter: "open" (problem exists), "mitigated" (reliable workaround), "fixed" (resolved and re-verified), "regressed" (was fixed, is back).
limit	integer	optional	Maximum results.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 2,
      "description": "Error string, symptom or keywords, e.g. \"flow times out after 100 seconds\"."
    },
    "category": {
      "type": "string",
      "enum": [
        "knowledge-grounding",
        "publish-channel",
        "auth-identity",
        "orchestration",
        "agent-flows",
        "llm-steps",
        "topics-variables",
        "tools",
        "alm-deployment",
        "licensing-cost",
        "governance-dlp",
        "observability",
        "security-defaults"
      ],
      "description": "Optional category filter."
    },
    "status": {
      "type": "string",
      "enum": [
        "open",
        "mitigated",
        "fixed",
        "regressed"
      ],
      "description": "Optional status filter: \"open\" (problem exists), \"mitigated\" (reliable workaround), \"fixed\" (resolved and re-verified), \"regressed\" (was fixed, is back)."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25,
      "default": 8,
      "description": "Maximum results."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

lookup_error

Exact/substring match against all known Copilot Studio error codes and error messages in the register. The fastest path when you have a verbatim error string (e.g. "FlowActionTimedOut"). Returns the matching record(s) with the citable URL.

Parameters1

error

string

required

The error code or error message, as verbatim as possible.

Raw schema

{
  "type": "object",
  "properties": {
    "error": {
      "type": "string",
      "minLength": 3,
      "description": "The error code or error message, as verbatim as possible."
    }
  },
  "required": [
    "error"
  ],
  "additionalProperties": false
}

get_friction_record

The complete friction record for a slug: status, dates, confidence, severity, time cost, categories, channels, license context, error codes/messages, dated evidence list, and the six body sections as markdown (symptom checklist, cause, fix with solution classes, verification steps, fallback, prevention). Cite the returned URL; a German version exists at the german_version URL.

Parameters1

slug

string

required

Record slug, e.g. "flowactiontimedout" (from search/list results).

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Record slug, e.g. \"flowactiontimedout\" (from search/list results)."
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false
}

list_frictions

Browse the register: compact list of all published friction records, sorted by last-verified date (newest first). Filter by status and/or category.

Parameters2

status	string	optional	Optional status filter: "open" (problem exists), "mitigated" (reliable workaround), "fixed" (resolved and re-verified), "regressed" (was fixed, is back).
category	string	optional	Optional category filter.

Raw schema

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "open",
        "mitigated",
        "fixed",
        "regressed"
      ],
      "description": "Optional status filter: \"open\" (problem exists), \"mitigated\" (reliable workaround), \"fixed\" (resolved and re-verified), \"regressed\" (was fixed, is back)."
    },
    "category": {
      "type": "string",
      "enum": [
        "knowledge-grounding",
        "publish-channel",
        "auth-identity",
        "orchestration",
        "agent-flows",
        "llm-steps",
        "topics-variables",
        "tools",
        "alm-deployment",
        "licensing-cost",
        "governance-dlp",
        "observability",
        "security-defaults"
      ],
      "description": "Optional category filter."
    }
  },
  "additionalProperties": false
}

get_current_drift

What is currently broken or regressed in Microsoft Copilot Studio, per the continuously verified Friction Index: all records with status open or regressed (newest status change first) plus register health counts (total records, share verified within 90 days, status distribution).

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

list_patterns

All reusable build patterns that prevent whole classes of Copilot Studio friction before they happen (e.g. async continuation for the 100-second flow limit), each with its problem class and related records.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

get_pattern

The complete prevention pattern for a slug: the pattern, when to use it, and step-by-step instructions as markdown, plus the friction records it protects against.

Parameters1

slug

string

required

Pattern slug, e.g. "async-continuation" (from list_patterns).

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Pattern slug, e.g. \"async-continuation\" (from list_patterns)."
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false
}

Install

Tools (7)

search_frictionslookup_errorget_friction_recordlist_frictionsget_current_driftlist_patternsget_pattern

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://pcghrrzwqshejvifoxjq.supabase.co/functions/v1/friction-mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "copilot-studio-friction-index": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://pcghrrzwqshejvifoxjq.supabase.co/functions/v1/friction-mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.