MCP (Streamable HTTP, stateless)

POST

/api/v1/mcp

curl --request POST \
  --url http://localhost:3000/api/v1/mcp \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "jsonrpc": "2.0", "id": "example", "method": "example", "params": "example" }'

JSON-RPC 2.0 for Model Context Protocol clients. Tools: search_assets, describe_asset, rendition_url, check_use, ingest_asset, import_google_font, find_icons, import_icons, brand_rules, my_proposals, propose_tags, review_asset, list_fields, create_field, update_field, delete_field, list_collections, create_collection, update_collection, update_collection_assets, delete_collection, brand_status, create_brand, update_brand, set_brand_hub, delete_brand, list_templates, brand_playbook, preview_page, list_pages, get_page, set_rules, save_page, edit_page, delete_page, generate_pages, get_theme, set_theme, list_versions, get_version, name_version, restore_version, list_comments, add_comment, update_comment, delete_comment, publish, list_sites, update_site, create_site, check_site, deploy_site, list_deployments, restore_deployment, close_site, delete_site, list_site_requests, decide_site_request, search_catalog, describe_object, lineage, share_object, who_can, review_assets, update_asset, update_assets, delete_asset, restore_asset, asset_versions, make_version_current, get_activity, get_insights, asset_insights, brand_insights, brand_updates, brand_assets, brand_tokens, create_share, list_shares, save_search, list_searches, list_members, object_activity, shared_with_us, list_projects, propose_fields, get_fixes, list_automations, create_automation, update_automation, delete_automation, test_automation, automation_runs, create_project, rename_project. Each tool checks its own scope. Resources: a brand’s rules (artbucket://brand/rules for the default brand, artbucket://brands/{slug}/rules for any, and /{context} after either for one context) and its pages as Markdown (artbucket://brands/{slug}/pages/{page}).

Scope: read.

Authorizations

• bearer
• session
• None

Request Body^required

Media typeapplication/json

object

jsonrpc

required

string

Allowed value: 2.0

id

string | number

method

required

string

params

Responses

200

A JSON-RPC response

Media typeapplication/json

object

jsonrpc

required

string

Allowed value: 2.0

id

required

result

error

Example

{
  "jsonrpc": "2.0"
}

202

A notification was accepted

default

An error

Media typeapplication/json

object

error

required

object

code

required

string

message

required

string

detail

Example^generated

{
  "error": {
    "code": "example",
    "message": "example",
    "detail": "example"
  }
}