Sign Customiser

Navigation

Dark mode

Store

get_store_manufacturer_link

read

Get store manufacturer link

Copy page

Tell the merchant which Find Sign Makers listing the Store is linked to, whether a link request is waiting, and whether the plan includes Pro for it.

Overview

Reads the Find Sign Makers link of the connected Store Company, as the merchant admin Find Sign Makers card shows it: whether a manufacturer listing is linked and which one, the link request that waits for the manufacturer to answer, and whether the subscription includes Find Sign Makers Pro for the linked listing, with the reason when it does not. A Company holds at most one link. It cannot ask for or remove a link, and the token emailed to the manufacturer is never returned. It requires the store:read scope and has no side effects.

Permission

Requires thestore:readpermission. A connection without it answersinsufficient_scopenaming the permission to approve.

Annotations

readOnlyHinttrue
destructiveHintfalse
idempotentHinttrue
openWorldHintfalse

Prerequisites

  • A merchant has connected this store and approved the store:read scope.

Arguments

This tool takes no arguments.

Result

The link state, any waiting request and the Pro eligibility.

request_idstringalways present
storeobjectalways present
store.idintegeralways present
store.namestringalways present
manufacturer_linkobjectalways present
manufacturer_link.is_linkedbooleanalways present
manufacturer_link.manufacturer_idinteger or null

The linked manufacturer, for get_manufacturer.

manufacturer_link.manufacturer_namestring or null
manufacturer_link.store_namestring or null
manufacturer_link.linked_atstring or null
manufacturer_link.pending_requestobject or null

The link request that waits for the manufacturer to answer, or null.

manufacturer_link.pending_request.manufacturer_idintegeralways present
manufacturer_link.pending_request.manufacturer_namestringalways present
manufacturer_link.pending_request.store_namestring or null
manufacturer_link.pending_request.expires_atstring or null
manufacturer_link.eligibilityobjectalways present

Whether the subscription includes Find Sign Makers Pro for the linked listing.

manufacturer_link.eligibility.qualifiesbooleanalways present
manufacturer_link.eligibility.reasonstringalways present

Expected to grow.

One of: qualifies, test_store, no_subscription, trial, past_due, free_plan

manufacturer_link.eligibility.included_untilstring or null

Error cases

insufficient_scope

The connection was approved without store:read.

A linked Store

tools/call
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_store_manufacturer_link",
    "arguments": {}
  }
}
result
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "structuredContent": {
      "request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t",
      "store": {
        "id": 12,
        "name": "Demo Signs"
      },
      "manufacturer_link": {
        "is_linked": true,
        "manufacturer_id": 318,
        "manufacturer_name": "Bright Signs Co",
        "store_name": "Demo Signs",
        "linked_at": "2026-09-02T04:00:00Z",
        "pending_request": null,
        "eligibility": {
          "qualifies": true,
          "reason": "qualifies",
          "included_until": "2026-12-01T00:00:00Z"
        }
      }
    }
  }
}

A connection without store:read (error)

tools/call
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_store_manufacturer_link",
    "arguments": {}
  }
}
result
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "isError": true,
    "structuredContent": {
      "error": {
        "code": "insufficient_scope",
        "title": "Insufficient scope",
        "detail": "The tool [get_store_manufacturer_link] requires the store:read scope, which this connection was not granted.",
        "recovery": "The connection was authorised without the scope this tool needs. Ask the merchant to reconnect the Sign Customiser connector and approve the scope named in required_scopes. If the approval screen does not offer that permission, ask them to remove the connector from this AI agent and add it again. Do not retry this call.",
        "required_scopes": [
          "store:read"
        ],
        "granted_scopes": [
          "customisers:read"
        ]
      }
    }
  }
}

Type a question and press Enter. Use the arrow keys to move between the results.