# Get store manufacturer link (`get_store_manufacturer_link`)

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.

- Source URL: https://www.signcustomiser.com/help/mcp/tools/get_store_manufacturer_link/
- Markdown URL: https://www.signcustomiser.com/help/mcp/tools/get_store_manufacturer_link.md
- MCP endpoint: https://mcp.signcustomiser.com
- Required scope: `store:read`
- Behaviour: read

## Purpose

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.

## Annotations

| Hint | Value |
| --- | --- |
| readOnlyHint | true |
| destructiveHint | false |
| idempotentHint | true |
| openWorldHint | false |

## 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.

| Property | Type | Required | Description |
| --- | --- | --- | --- |
| `request_id` | string | yes |  |
| `store` | object | yes |  |
| `store.id` | integer | yes |  |
| `store.name` | string | yes |  |
| `manufacturer_link` | object | yes |  |
| `manufacturer_link.is_linked` | boolean | yes |  |
| `manufacturer_link.manufacturer_id` | integer or null | no | The linked manufacturer, for get_manufacturer. |
| `manufacturer_link.manufacturer_name` | string or null | no |  |
| `manufacturer_link.store_name` | string or null | no |  |
| `manufacturer_link.linked_at` | string or null | no |  |
| `manufacturer_link.pending_request` | object or null | no | The link request that waits for the manufacturer to answer, or null. |
| `manufacturer_link.pending_request.manufacturer_id` | integer | yes |  |
| `manufacturer_link.pending_request.manufacturer_name` | string | yes |  |
| `manufacturer_link.pending_request.store_name` | string or null | no |  |
| `manufacturer_link.pending_request.expires_at` | string or null | no |  |
| `manufacturer_link.eligibility` | object | yes | Whether the subscription includes Find Sign Makers Pro for the linked listing. |
| `manufacturer_link.eligibility.qualifies` | boolean | yes |  |
| `manufacturer_link.eligibility.reason` | string | yes | Expected to grow. One of: `qualifies`, `test_store`, `no_subscription`, `trial`, `past_due`, `free_plan`. |
| `manufacturer_link.eligibility.included_until` | string or null | no |  |

## Error cases

| Code | Recovery |
| --- | --- |
| `insufficient_scope` | The connection was approved without store:read. |

## Example: A linked Store

Request:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_store_manufacturer_link",
    "arguments": {}
  }
}
```

Response:

```json
{
  "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"
        }
      }
    }
  }
}
```

## Example: A connection without store:read (error)

Request:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_store_manufacturer_link",
    "arguments": {}
  }
}
```

Response:

```json
{
  "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"
        ]
      }
    }
  }
}
```
