{
  "info": {
    "name": "Folk — mcp.ai",
    "description": "REST API for the Folk 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/folk",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "folk_create_company",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/company",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "company"
          ]
        },
        "description": "Creates a new company in the Folk workspace with the specified details. Required: company name (unique identifier). Optional: description, industry, funding details, employee range, contact info (emai",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"name\": \"\",\n  \"urls\": \"\",\n  \"emails\": \"\",\n  \"groups\": \"\",\n  \"phones\": \"\",\n  \"industry\": \"\",\n  \"addresses\": \"\",\n  \"description\": \"\",\n  \"employeeRange\": \"\",\n  \"fundingRaised\": \"\",\n  \"foundationYear\": \"\",\n  \"lastFundingDate\": \"\",\n  \"customFieldValues\": {}\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "folk_create_note",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/note",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "note"
          ]
        },
        "description": "Tool to create a new note in the Folk workspace. Use when you need to add a note to a person, company, or deal entity.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"entity\": {},\n  \"content\": \"\",\n  \"parentNote\": {},\n  \"visibility\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "folk_create_person",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/person",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "person"
          ]
        },
        "description": "Creates a new person in the Folk workspace with the specified details. Optional fields include: first name, last name, emails, phones, group assignments, and custom field values. The first email/phone",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"emails\": \"\",\n  \"groups\": \"\",\n  \"phones\": \"\",\n  \"lastName\": \"\",\n  \"firstName\": \"\",\n  \"customFieldValues\": {}\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "folk_delete_company",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/company",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "company"
          ]
        },
        "description": "Tool to delete a company from the workspace (irreversible). Use after confirming this company should be removed.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"company_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "folk_delete_note",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/note",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "note"
          ]
        },
        "description": "Tool to delete an existing note in the workspace (irreversible). Use after confirming this note should be permanently removed.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"note_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "folk_delete_person",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/person",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "person"
          ]
        },
        "description": "Tool to delete an existing person in the workspace (irreversible). Use after confirming this person should be permanently removed.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"person_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "folk_delete_reminder",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/reminder",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "reminder"
          ]
        },
        "description": "Tool to delete an existing reminder in the workspace (irreversible). Use after confirming this reminder should be permanently removed.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"reminder_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "folk_get_company",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/company",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "company"
          ]
        },
        "description": "Tool to retrieve an existing company by its ID. Use after authentication has been verified.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"company_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "folk_get_current_workspace_user",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/current/workspace/user",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "current",
            "workspace",
            "user"
          ]
        },
        "description": "Tool to get details of the current authenticated workspace user. Use after authentication to retrieve the user's profile information.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "folk_get_note",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/note",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "note"
          ]
        },
        "description": "Tool to retrieve an existing note by its ID. Use when you need the full content and metadata of a specific note.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"note_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "folk_get_person",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/person",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "person"
          ]
        },
        "description": "Tool to retrieve an existing person by their ID. Use when you need full profile details of a person by their unique identifier.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"person_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "folk_get_user",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/user",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "user"
          ]
        },
        "description": "Tool to retrieve a user by their unique identifier. Use when you need to get details of a specific workspace user.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"user_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "folk_list_companies",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/companies",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "companies"
          ]
        },
        "description": "Tool to list companies in the workspace. Use when you need a paginated overview of companies, optionally filtered.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"limit\": 0,\n  \"cursor\": \"\",\n  \"filter\": {},\n  \"combinator\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "folk_list_group_custom_fields",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/group/custom/fields",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "group",
            "custom",
            "fields"
          ]
        },
        "description": "Tool to list custom fields for a specific group and entity type. Use after selecting a group and entity type to inspect available custom fields.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"limit\": 0,\n  \"cursor\": \"\",\n  \"group_id\": \"\",\n  \"entity_type\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "folk_list_groups",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/groups",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "groups"
          ]
        },
        "description": "Tool to list workspace groups. Use when you need to retrieve a paginated list of all workspace groups after authentication.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"limit\": 0,\n  \"cursor\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "folk_list_notes",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/notes",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "notes"
          ]
        },
        "description": "Tool to list notes in the workspace. Use when you need to retrieve notes with pagination support.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"limit\": 0,\n  \"cursor\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "folk_list_people",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/people",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "people"
          ]
        },
        "description": "Tool to list people in the workspace. Use when you need to paginate through contacts after authentication.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"limit\": 0,\n  \"cursor\": \"\",\n  \"filter\": {},\n  \"combinator\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "folk_list_reminders",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/reminders",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "reminders"
          ]
        },
        "description": "Tool to list reminders in the workspace. Use when you need a paginated overview of reminders, optionally filtered by entity.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"limit\": 0,\n  \"cursor\": \"\",\n  \"entity_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "folk_list_users",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/users",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "users"
          ]
        },
        "description": "Tool to list workspace users. Use when you need to paginate through users list.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"limit\": 0,\n  \"cursor\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "folk_list_webhooks",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/webhooks",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "webhooks"
          ]
        },
        "description": "Tool to list webhooks in the workspace. Use when you need to retrieve configured webhooks with pagination support.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"limit\": 0,\n  \"cursor\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "folk_update_company",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/company",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "company"
          ]
        },
        "description": "Tool to update an existing company in the workspace. Use after confirming the company ID; only provided fields are updated and list fields replace existing values.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"name\": \"\",\n  \"urls\": \"\",\n  \"emails\": \"\",\n  \"groups\": \"\",\n  \"phones\": \"\",\n  \"addresses\": \"\",\n  \"companyId\": \"\",\n  \"description\": \"\",\n  \"customFieldValues\": {}\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "folk_update_note",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/note",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "note"
          ]
        },
        "description": "Tool to update an existing note in the workspace. Use after confirming the note ID; only provided fields are updated.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"content\": \"\",\n  \"note_id\": \"\",\n  \"visibility\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "folk_update_person",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/person",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "person"
          ]
        },
        "description": "Tool to update an existing person in the workspace. Use after confirming the person ID; only provided fields are updated and list fields replace existing values.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"urls\": \"\",\n  \"emails\": \"\",\n  \"groups\": \"\",\n  \"phones\": \"\",\n  \"birthday\": \"\",\n  \"fullName\": \"\",\n  \"jobTitle\": \"\",\n  \"lastName\": \"\",\n  \"personId\": \"\",\n  \"addresses\": \"\",\n  \"companies\": \"\",\n  \"firstName\": \"\",\n  \"description\": \"\",\n  \"customFieldValues\": {}\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}