# Search manufacturer link listings (`search_manufacturer_link_listings`)

Finds the Find Sign Makers listings the connected Store could ask to link, as the merchant admin link picker does: only listings a manufacturer account claimed, whose name, profile slug or location contains the search term (2 to 100 characters after trimming). It returns at most 10 listings in name order, each with its manufacturer id, name, location, whether another Store holds it and whether it is publicly verified; send a longer term to find a listing that is not shown. It cannot ask for a link. Each connection can search 30 times a minute. It requires the store:read scope and has no side effects.

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

## Purpose

Find the listing a merchant wants to link, so they can ask for the link in the merchant admin.

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

| Property | Type | Required | Description |
| --- | --- | --- | --- |
| `search` | string | yes | The term the listing name, profile slug or location must contain, with the same case. It is trimmed and must then have 2 to 100 characters. |

## Result

At most 10 matching listings in name order, in one page.

| Property | Type | Required | Description |
| --- | --- | --- | --- |
| `request_id` | string | yes |  |
| `store` | object | yes |  |
| `store.id` | integer | yes |  |
| `store.name` | string | yes |  |
| `listings` | array of object | yes | At most 10 listings, in name order. |
| `listings[].manufacturer_id` | integer | yes |  |
| `listings[].name` | string | yes |  |
| `listings[].location` | string or null | no |  |
| `listings[].is_linked` | boolean | yes | True when another Store holds the listing. |
| `listings[].is_publicly_verified` | boolean | yes |  |
| `pagination` | object | yes |  |
| `pagination.has_more` | boolean | yes |  |
| `pagination.next_cursor` | string or null | no |  |

## Error cases

| Code | Recovery |
| --- | --- |
| `insufficient_scope` | The connection was approved without store:read. |
| `invalid_parameter` | The search term has fewer than 2 or more than 100 characters after it is trimmed. |
| `rate_limited` | This connection has searched 30 times in the last minute. Wait retry_after seconds. |

## Example: Listings matching a name

Request:

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

Response:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "structuredContent": {
      "request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t",
      "store": {
        "id": 12,
        "name": "Demo Signs"
      },
      "listings": [
        {
          "manufacturer_id": 318,
          "name": "Bright Signs Co",
          "location": "Brisbane, Australia",
          "is_linked": false,
          "is_publicly_verified": true
        }
      ],
      "pagination": {
        "has_more": false,
        "next_cursor": null
      }
    }
  }
}
```

## Example: A search term that is too short (error)

Request:

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

Response:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "isError": true,
    "structuredContent": {
      "error": {
        "code": "invalid_parameter",
        "title": "Invalid query parameter",
        "detail": "The filter[search] term must have 2 to 100 characters after it is trimmed.",
        "parameter": "filter[search]",
        "recovery": "Correct the parameter named in parameter. Dates are YYYY-MM-DD in UTC and identifiers are integers between 1 and 2147483647."
      }
    }
  }
}
```
