Docs

Tool reference.

The 9 tools in Motif's contract, with live status from the running service.

9 live, 0 coming

Status comes from the tool list of the running service release (service release 9328719), not from a plan. A tool marked Coming soon isn't callable yet; your agent won't see it in tools/list.

Every call that uses allowance takes an idempotency_key: a fresh random string per request, reused only to retry the same request, so a retry is never counted twice. Responses are capped at 64 KiB.

search_design_knowledge

Live

Search design guidance

Finds the guides that fit a task. Returns titles, short abstracts and ids (at most five), never guide bodies.

Counts as
Uses 1 content operation when it succeeds. A search that finds nothing still counts; failed, invalid and denied calls don't.
Permission
Search the catalog · Reads only
ArgumentAcceptsRequired or optional
queryText, up to 2,000 charactersRequired
platformOne of: website, web_app, ios_app, android_app, desktop_app, cross_platform_appOptional
workflowText, up to 128 charactersOptional
frameworkText, up to 128 charactersOptional
project_idAn id (UUID)Optional
limitA whole number from 1 to 5Optional
idempotency_keyText, up to 128 charactersRequired

get_design_guidance

Live

Open a design guide

Opens one guide's sections (overview, implementation, verification, limitations) within a context budget you can set.

Counts as
Uses 1 content operation. Each premium guide it opens also counts once per billing window toward your premium-guide allowance; opening the same guide again that window doesn't count again.
Permission
Read guidance you're entitled to · Reads only
ArgumentAcceptsRequired or optional
item_idTextRequired
versionTextOptional
sectionsA list of up to 4: one of: overview, implementation, verification, limitationsOptional
context_budget_tokensA whole number from 500 to 6000Optional
project_idAn id (UUID)Optional
idempotency_keyText, up to 128 charactersRequired

check_design_contract

Live

Check design rules

Checks facts your agent measured (contrast ratios, target sizes, measure, motion timing, LCP and more) against deterministic rules. Missing evidence is reported as unknown, never as a pass.

Counts as
Uses 1 content operation. If the result includes premium guidance, each guide counts once per billing window toward your premium-guide allowance.
Permission
Read guidance you're entitled to · Reads only
ArgumentAcceptsRequired or optional
rule_idsA list of up to 50: textRequired
factsAn objectRequired
evidence_refsA list of up to 50: text, up to 256 charactersOptional
project_idAn id (UUID)Optional
idempotency_keyText, up to 128 charactersRequired

get_design_pack

Live

Get a design pack

Returns an authored design pack that fits a product brief: a direction, tokens, the guides to follow and the checks to run. No hosted model writes it on the fly.

Counts as
Uses 1 content operation. Each premium guide the pack delivers counts once per billing window toward your premium-guide allowance.
Permission
Search the catalog, read guidance you're entitled to · Reads only
ArgumentAcceptsRequired or optional
pack_idTextOptional
versionTextOptional
product_briefText, up to 4,000 charactersRequired
platformOne of: website, web_app, ios_app, android_app, desktop_app, cross_platform_appRequired
workflowText, up to 128 charactersOptional
project_idAn id (UUID)Optional
context_budget_tokensA whole number from 500 to 6000Optional
idempotency_keyText, up to 128 charactersRequired

activate_template

Live

Activate a template family

Adds a template family to your library within the plan you already have. It never charges money.

Counts as
The first time you activate a premium family it counts toward your new-family allowance, for good: activating it again, or getting its updates, never counts again. Free families never count.
Permission
Activate template families · Changes your account data
ArgumentAcceptsRequired or optional
family_idTextRequired
expected_policy_versionText, up to 128 charactersRequired
idempotency_keyText, up to 128 charactersRequired

get_template_download

Live

Download a template

Issues a short-lived, single-archive download for a family in your library. Treat the returned link as a secret; it expires in five minutes.

Counts as
Doesn't use content operations. Reserves the archive's size against your download allowance, and only a limited number of downloads can run at once.
Permission
Download activated templates · Changes your account data
ArgumentAcceptsRequired or optional
family_idTextRequired
versionTextOptional
idempotency_keyText, up to 128 charactersRequired

get_project_profile

Live

Read a project profile

Reads your project's brief, platforms and approved decisions, so every agent you use builds to the same choices.

Counts as
Doesn't use your content allowance. Only the per-minute request rate applies.
Permission
Read your project profiles · Reads only
ArgumentAcceptsRequired or optional
project_idAn id (UUID)Required

propose_project_decision

Live

Propose a project decision

Suggests a decision (for example a type scale) for you to approve in the browser. An agent can't approve or overwrite a decision itself.

Counts as
Doesn't use your content allowance. Only the per-minute request rate applies.
Permission
Propose project decisions · Changes your account data
ArgumentAcceptsRequired or optional
project_idAn id (UUID)Required
expected_revisionA whole number from 0 to 1000000000000Required
proposal_textText, up to 16,000 charactersRequired
rationaleText, up to 4,000 charactersRequired
idempotency_keyText, up to 128 charactersRequired

get_usage

Live

Show plan and usage

Shows your plan, every allowance, what's left and when each resets. Doesn't use any allowance, so it's the call to try first.

Counts as
Doesn't use your content allowance. Only the per-minute request rate applies.
Permission
Read your plan and usage · Reads only

No arguments.