Design Brief Builder

Name: Design Brief Builder
Availability: InStock
Author: Kata Team

Reads the Figma file and writes the brief — including the states nobody designed.

Requires external credentials

After connecting, this agent asks for your own API keys for third-party services to work. Only provide keys you trust this agent with — review its setup before connecting any account.

Works with

Claude (web & desktop)ChatGPT (Plus / Pro)CursorVS Code (Copilot)Claude CodeGemini CLIWindsurfClineContinueZedLM StudioGooseJetBrains AI AssistantWarpPostmanand more

Before you connect: what this agent would do

A preview derived from this agent’s definition — not a live run. Nothing runs and no key is sent until you connect. FindAgent runs it on the hosted connection.

Tools it can use (5)

get_fileRead-only
Fetch a Figma file's page and frame structure, to see how the work is organised.
Reaches: api.figma.com
Uses your Figma personal access token.
get_file_nodesRead-only
Fetch specific frames in full, including their components, text, and styles.
Reaches: api.figma.com
Uses your Figma personal access token.
get_file_commentsRead-only
Fetch the comments on a file, where decisions and objections usually live.
Reaches: api.figma.com
Uses your Figma personal access token.
get_requirementRead-only
Fetch the Jira issue this design serves, to compare intent against what the frames show.
Reaches: {jira_site}.atlassian.net
Uses your Atlassian Cloud token.
create_brief_pageCan change data
Create the design brief as a new Confluence page for review.
Reaches: {confluence_site}.atlassian.net
Uses your Atlassian Cloud token.

Credentials it will ask for (2)

Figma personal access token
Only ever sent to: api.figma.com
Format: Enter just the key value — FindAgent sends it as the X-Figma-Token header.
Atlassian Cloud token
Only ever sent to: atlassian.net
Format: Paste the Base64 encoding of “id:token” (e.g. your email and API token joined by a colon), not the raw token. Many tools show this ready-made as your “Basic auth” value.

Safety rails that guard it

Every result is scanned for leaked secrets and prompt-injection before it reaches you — a check no agent can turn off.
These personal details are removed from your input before the agent sees them: Credit card, IBAN, National ID.
These personal details are stripped from the agent’s results before you see them: Email, Phone.
A request larger than 200,000 characters is rejected before it runs.
get_fileRate limited to 120/hour.Safe to retry automatically if a run is interrupted.
get_file_nodesRate limited to 300/hour.Safe to retry automatically if a run is interrupted.
get_requirementRate limited to 200/hour.Safe to retry automatically if a run is interrupted.
create_brief_pageSensitive — it is flagged and needs an explicit confirmation before it runs.Rate limited to 20/hour.Runs only after get_file_nodes has run first.
get_file_commentsRate limited to 120/hour.Safe to retry automatically if a run is interrupted.

How FindAgent keeps agents safe

Run locally

This MCP server runs on your own machine — FindAgent only points you at it. Run the command below, then add it to your MCP client. Nothing is hosted or proxied on our side.

terminal

npx -y @findagent/mcp run

Add it to your MCP client

Paste this into your client config (e.g. claude_desktop_config.json or a Cursor mcp.json), then restart the client.

mcp client config

{
  "mcpServers": {
    "design-brief-builder": {
      "command": "npx",
      "args": [
        "-y",
        "@findagent/mcp",
        "run"
      ]
    }
  }
}

What you'll need — and where to get it

This agent will ask you for the following. You enter them when you connect — they're encrypted and never shared with the creator.

Figma personal access token
A Figma personal access token from Settings > Account > Personal access tokens. Paste the bare token — the runtime sends it in the X-Figma-Token header. File-read scope is enough; this agent never edits a file.
Get this from figma.com's account or API settings.
Paste the value as a single line.
Only sent to: api.figma.com
Atlassian Cloud token
Base64 of 'your-email:your-api-token' — encode it yourself; the runtime only adds the Basic prefix. Needs Browse Projects in Jira and page create in the target Confluence space.
Get this from atlassian.net's account or API settings.
Paste the value as a single line.
Only sent to: atlassian.net