{
  "info": {
    "name": "Linkly — mcp.ai",
    "description": "REST API for the Linkly MCP. Set {{apiKey}} to a workspace key (sk_live_…) created at https://mcp.ai/settings/api-keys.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{apiKey}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.mcp.ai/api/linkly",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "linkly_create_or_update_link",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/or/update/link",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "or",
            "update",
            "link"
          ]
        },
        "description": "Tool to create a new shortened link or update an existing one in Linkly. Use when you need to generate a trackable short URL with custom parameters, UTM tracking, retargeting pixels, or Open Graph met",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": 0,\n  \"url\": \"\",\n  \"name\": \"\",\n  \"slug\": \"\",\n  \"rules\": \"\",\n  \"domain\": \"\",\n  \"gtm_id\": \"\",\n  \"enabled\": false,\n  \"cloaking\": false,\n  \"og_image\": \"\",\n  \"og_title\": \"\",\n  \"utm_term\": \"\",\n  \"block_bots\": false,\n  \"ga4_tag_id\": \"\",\n  \"utm_medium\": \"\",\n  \"utm_source\": \"\",\n  \"fb_pixel_id\": \"\",\n  \"utm_content\": \"\",\n  \"utm_campaign\": \"\",\n  \"workspace_id\": 0,\n  \"hide_referrer\": false,\n  \"forward_params\": false,\n  \"og_description\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "linkly_delete_link",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/link",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "link"
          ]
        },
        "description": "Tool to delete a specific link by ID from a workspace. Use when you need to permanently remove a link. This action is permanent and cannot be undone.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": 0,\n  \"workspace_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "linkly_delete_links",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/links",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "links"
          ]
        },
        "description": "Tool to delete one or more links by their IDs. This action is permanent and cannot be undone. Use when you need to remove links from a workspace.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"ids\": \"\",\n  \"workspace_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "linkly_export_links",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/export/links",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "export",
            "links"
          ]
        },
        "description": "Tool to export all links in a workspace as JSON or CSV. Use when you need to retrieve all links for backup, analysis, or migration purposes.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"format\": \"\",\n  \"search\": \"\",\n  \"workspace_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "linkly_get_click_counters",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/click/counters",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "click",
            "counters"
          ]
        },
        "description": "Tool to retrieve click analytics grouped by a specific dimension (counter). Returns aggregated counts for each unique value of the selected dimension. Use when you need to analyze click patterns by co",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"end\": \"\",\n  \"bots\": false,\n  \"start\": \"\",\n  \"format\": \"\",\n  \"unique\": false,\n  \"counter\": \"\",\n  \"country\": \"\",\n  \"link_id\": \"\",\n  \"link_ids\": \"\",\n  \"workspace_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "linkly_get_clicks",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/clicks",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "clicks"
          ]
        },
        "description": "Tool to retrieve click analytics for a workspace. Filter by link, date range, country, and more. Returns time-series data suitable for charting.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"end\": \"\",\n  \"isp\": \"\",\n  \"bots\": false,\n  \"pivot\": \"\",\n  \"start\": \"\",\n  \"format\": \"\",\n  \"unique\": false,\n  \"browser\": \"\",\n  \"country\": \"\",\n  \"link_id\": \"\",\n  \"referer\": \"\",\n  \"link_ids\": \"\",\n  \"platform\": \"\",\n  \"timezone\": \"\",\n  \"frequency\": \"\",\n  \"workspace_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "linkly_get_link",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/link",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "link"
          ]
        },
        "description": "Tool to retrieve detailed information about a specific link by its ID. Use when you need to fetch link configuration, UTM parameters, or click statistics.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\",\n  \"workspace_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "linkly_get_link_by_id",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/link/by/id",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "link",
            "by",
            "id"
          ]
        },
        "description": "Tool to retrieve details for a specific link by ID. Use when you need to fetch information about a shortened link, including its destination URL, click statistics, and configuration settings.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "linkly_list_domains",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/domains",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "domains"
          ]
        },
        "description": "Tool to retrieve all custom domains configured for a workspace. Use when you need to see available domains for creating short links.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"page_size\": 0,\n  \"workspace_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "linkly_list_link_webhooks",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/link/webhooks",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "link",
            "webhooks"
          ]
        },
        "description": "Tool to retrieve all webhook subscriptions for a specific link. Use when you need to see what webhooks are configured for a link.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"link_id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "linkly_list_links",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/links",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "links"
          ]
        },
        "description": "Tool to get a paginated list of all links in a workspace. Supports search, sorting, and pagination. Returns link details including click statistics. Use when you need to retrieve or search through lin",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"search\": \"\",\n  \"sort_by\": \"\",\n  \"sort_dir\": \"\",\n  \"page_size\": 0,\n  \"workspace_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "linkly_list_workspace_webhooks",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/workspace/webhooks",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "workspace",
            "webhooks"
          ]
        },
        "description": "Tool to list all webhook subscriptions for a specific workspace. Use when you need to retrieve or view the configured webhooks for a workspace.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"workspace_id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "linkly_list_workspaces",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/workspaces",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "workspaces"
          ]
        },
        "description": "Tool to retrieve all workspaces the authenticated user has access to. Use this to discover available workspace IDs for other API calls.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "linkly_subscribe_webhook_to_link",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/subscribe/webhook/to/link",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "subscribe",
            "webhook",
            "to",
            "link"
          ]
        },
        "description": "Tool to subscribe a webhook URL to receive notifications when a specific link is clicked. Use when you need to track click events for a shortened link.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"url\": \"\",\n  \"link_id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "linkly_subscribe_webhook_to_workspace",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/subscribe/webhook/to/workspace",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "subscribe",
            "webhook",
            "to",
            "workspace"
          ]
        },
        "description": "Tool to subscribe a webhook URL to receive click notifications from a Linkly workspace. Use when you need to set up real-time notifications for link clicks. The webhook will receive POST requests cont",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"url\": \"\",\n  \"workspace_id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "linkly_unsubscribe_webhook_from_link",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/unsubscribe/webhook/from/link",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "unsubscribe",
            "webhook",
            "from",
            "link"
          ]
        },
        "description": "Tool to remove a webhook subscription from a link. Use when you need to stop receiving webhook events for a specific link.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"hook_id\": \"\",\n  \"link_id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "linkly_unsubscribe_webhook_from_workspace",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/unsubscribe/webhook/from/workspace",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "unsubscribe",
            "webhook",
            "from",
            "workspace"
          ]
        },
        "description": "Tool to remove a webhook subscription from a workspace. Use when you need to unsubscribe a webhook URL from receiving events for a specific workspace.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"hook_id\": \"\",\n  \"workspace_id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}