{
  "info": {
    "name": "Formdesk — mcp.ai",
    "description": "REST API for the Formdesk 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/formdesk",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "formdesk_automatic_login",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/automatic/login",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "automatic",
            "login"
          ]
        },
        "description": "Validates the Formdesk API bearer token and returns authentication details. This action confirms that your connected Formdesk account credentials are valid by making a test API call to the /forms endp",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"password\": \"\",\n  \"username\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "formdesk_create_entry",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/entry",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "entry"
          ]
        },
        "description": "Submit a new entry (result) to a Formdesk form. This action creates a new form submission with the provided field values. Before using this action: 1. Use FORMDESK_GET_FORM_LIST to find the form ID 2.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"fields\": {},\n  \"formId\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "formdesk_create_field",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/field",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "field"
          ]
        },
        "description": "Creates a new field in a Formdesk form. Use this action to add fields like text inputs, email fields, textareas, checkboxes, date pickers, etc. to an existing form. You must have the form ID from FORM",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"field\": {},\n  \"formId\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "formdesk_create_visitor",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/visitor",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "visitor"
          ]
        },
        "description": "Tool to add a new visitor to a specific Formdesk form. Use when you need to register a visitor's metadata before submitting entries.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"formId\": \"\",\n  \"visitor\": {}\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "formdesk_delete_entry",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/entry",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "entry"
          ]
        },
        "description": "Deletes a specific entry (form submission/result) from a Formdesk form. This action is idempotent - it will succeed even if the entry doesn't exist (404), making it safe to call multiple times. Use th",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"formId\": \"\",\n  \"entryId\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "formdesk_delete_field",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/field",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "field"
          ]
        },
        "description": "Tool to delete a specific field in a Formdesk form. Use after confirming formId and fieldId.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"form_id\": \"\",\n  \"field_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "formdesk_delete_form",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/form",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "form"
          ]
        },
        "description": "Delete a specific form from Formdesk. This action permanently removes a form from the Formdesk account. Use with caution as this operation is destructive and cannot be undone. If the form ID does not ",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"form_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "formdesk_delete_visitor",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/visitor",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "visitor"
          ]
        },
        "description": "Deletes a specific visitor from a Formdesk form. This action is idempotent - it will succeed even if the visitor doesn't exist (404), making it safe to call multiple times. Use this to remove a visito",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"form_id\": \"\",\n  \"visitor_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "formdesk_get_field_details",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/field/details",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "field",
            "details"
          ]
        },
        "description": "Retrieves comprehensive details about a specific field in a Formdesk form. Returns structured information including field ID, name, type (e.g., text, email, number), label, validation rules, and wheth",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"formId\": \"\",\n  \"fieldId\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "formdesk_get_form_details",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/form/details",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "form",
            "details"
          ]
        },
        "description": "Retrieves comprehensive details about a specific Formdesk form by its ID. Returns form metadata including name, description, active status, timestamps, public URL, and configuration settings. Use this",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"formId\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "formdesk_get_form_fields",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/form/fields",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "form",
            "fields"
          ]
        },
        "description": "Tool to retrieve all fields of a specific form. Use after obtaining the formId to inspect its field definitions.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"formId\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "formdesk_get_form_list",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/form/list",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "form",
            "list"
          ]
        },
        "description": "Retrieve a list of all forms in the Formdesk account. This action returns basic information about each form including its ID and name. Use the form ID with other actions (like Get Form Details, Get Fo",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "formdesk_get_form_visitors",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/form/visitors",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "form",
            "visitors"
          ]
        },
        "description": "Retrieves all visitors registered to access a specific Formdesk form. Visitors are users who have been granted access to view or complete a form. This action returns visitor details including their cr",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"form_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "formdesk_get_visitor_details",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/visitor/details",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "visitor",
            "details"
          ]
        },
        "description": "Retrieve complete details of a specific visitor in a Formdesk form. A visitor represents a unique person or entity who can submit entries to a form. Visitors have attributes (name, email, custom field",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"form_id\": \"\",\n  \"visitor_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "formdesk_kvk_handelsregister_lookup",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/kvk/handelsregister/lookup",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "kvk",
            "handelsregister",
            "lookup"
          ]
        },
        "description": "Tool to lookup company details from the Dutch KVK Handelsregister. Use when auto-filling company address fields.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"street\": \"\",\n  \"kvkNumber\": \"\",\n  \"postalCode\": \"\",\n  \"companyName\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "formdesk_manage_visitor_entries",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/manage/visitor/entries",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "manage",
            "visitor",
            "entries"
          ]
        },
        "description": "Retrieve form entries (submissions) from a Formdesk form. This action fetches submission data from a form's results database. You can: - List all entries in a form - Filter entries by visitor ID - Ret",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"form_id\": \"\",\n  \"entry_id\": \"\",\n  \"visitor_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "formdesk_multiple_pages_form",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/multiple/pages/form",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "multiple",
            "pages",
            "form"
          ]
        },
        "description": "Tool to create a multi-page Formdesk form. Use when you need forms split into multiple pages for better user experience.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"form\": {}\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "formdesk_update_field",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/field",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "field"
          ]
        },
        "description": "Updates properties of an existing field in a Formdesk form. This action modifies field configuration such as labels, types, validation rules, required status, placeholder text, help text, and default ",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"formId\": \"\",\n  \"fieldId\": \"\",\n  \"properties\": {}\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "formdesk_update_form",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/form",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "form"
          ]
        },
        "description": "Updates properties of an existing form in Formdesk. Use this action to: - Rename a form - Activate or deactivate a form (control whether it accepts responses) - Update other form metadata At least one",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"name\": \"\",\n  \"formId\": \"\",\n  \"isActive\": false\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "formdesk_update_visitor",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/visitor",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "visitor"
          ]
        },
        "description": "Update an existing visitor's attributes in a Formdesk form. A visitor represents a unique person or entity who can submit entries to a form. This action modifies visitor attributes such as name, email",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"formId\": \"\",\n  \"visitor\": {},\n  \"visitorId\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}