{
  "info": {
    "name": "Refiner — mcp.ai",
    "description": "REST API for the Refiner 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/refiner",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "refiner_delete_contact",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/contact",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "contact"
          ]
        },
        "description": "Tool to delete a specific contact by its identifier. Provide either the user ID or email address to identify and delete the contact.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\",\n  \"email\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "refiner_get_account_info",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/account/info",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "account",
            "info"
          ]
        },
        "description": "Retrieves Refiner account information including subscription plan, usage limits, and environment statistics. This action provides: - Current subscription plan and usage limits (MTU, MTE, MPV, MSR) - U",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "refiner_get_contact",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/contact",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "contact"
          ]
        },
        "description": "Retrieve detailed information about a specific contact using their ID, email, or UUID. Returns all stored attributes, segments, and account information.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\",\n  \"uuid\": \"\",\n  \"email\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "refiner_get_contacts",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/contacts",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "contacts"
          ]
        },
        "description": "Tool to retrieve a list of contacts from your Refiner account. Use when you need to filter or paginate through contacts.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"search\": \"\",\n  \"order_by\": \"\",\n  \"form_uuid\": \"\",\n  \"page_cursor\": \"\",\n  \"page_length\": 0,\n  \"segment_uuid\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "refiner_get_forms",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/forms",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "forms"
          ]
        },
        "description": "Tool to retrieve a list of forms (surveys) from your Refiner account with optional filtering and pagination. Use when you need to list surveys by state, page, or include extra info/config.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"list\": \"\",\n  \"page\": 0,\n  \"page_length\": 0,\n  \"include_info\": false,\n  \"include_config\": false\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "refiner_get_reporting",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/reporting",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "reporting"
          ]
        },
        "description": "Tool to retrieve aggregated reporting data for surveys including metrics and analytics. Use when you need survey analytics over a time range filtered by type, question identifiers, tags, forms, or seg",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"type\": \"\",\n  \"tag_uuids\": \"\",\n  \"form_uuids\": \"\",\n  \"segment_uuids\": \"\",\n  \"date_range_end\": \"\",\n  \"date_range_start\": \"\",\n  \"question_identifiers\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "refiner_get_responses",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/responses",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "responses"
          ]
        },
        "description": "Tool to retrieve all survey responses from your Refiner account with optional filtering and pagination. Use after confirming survey creation to pull response data.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"search\": \"\",\n  \"include\": \"\",\n  \"form_uuid\": \"\",\n  \"form_uuids\": \"\",\n  \"page_cursor\": \"\",\n  \"page_length\": 0,\n  \"segment_uuid\": \"\",\n  \"segment_uuids\": \"\",\n  \"date_range_end\": \"\",\n  \"with_attributes\": false,\n  \"date_range_start\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "refiner_get_segments",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/segments",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "segments"
          ]
        },
        "description": "Tool to retrieve a list of user segments from your Refiner account. Use when you need to view or paginate segments.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"page_cursor\": \"\",\n  \"page_length\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "refiner_track_event",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/track/event",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "track",
            "event"
          ]
        },
        "description": "Tool to record a user event by name for a user identified via user ID or email. Use after confirming the identifier and event name.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\",\n  \"email\": \"\",\n  \"event\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "refiner_update_contact",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/contact",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "contact"
          ]
        },
        "description": "Tool to create or update a contact's attributes or account. Identifies a contact by `id` or `email` and updates their traits or account grouping. If the contact doesn't exist, it will be created autom",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\",\n  \"email\": \"\",\n  \"account\": {},\n  \"attributes\": {}\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}