> ## Documentation Index > Fetch the complete documentation index at: https://docs.peepsai.com/llms.txt > Use this file to discover all available pages before exploring further. # peeps MCP server tools reference and parameter guide > Complete reference for all tools exposed by the peeps MCP server: search_people, get_person, search_organizations, get_organization, and list_contacts. The peeps MCP server exposes five tools that your AI assistant can invoke to search, retrieve, and paginate over people and organization data in your workspace. Each tool accepts structured parameters and returns typed JSON — your assistant can chain them together, filter results, and reason over the data in a single conversation turn. *** ## search\_people Search for people in your workspace by name, job title, email address, or the organization they belong to. Use this tool when you need to find one or more contacts matching a text query. ### Parameters The search string. Match against a person's name, job title, email address, or organization name. Example: `"engineers at Acme"` or `"jane@example.com"`. Maximum number of results to return. Defaults to `10`. Maximum value is `100`. Filter results to people who belong to a specific organization. Use the organization's `id` field from a prior `search_organizations` or `get_organization` call. ### Returns An array of person summary objects. Unique identifier for the person. Use this with `get_person` to retrieve the full profile. Full name of the person. Primary email address. Job title. Name of the organization the person is associated with. ### Example prompt ```text theme={null} Find all engineers at Acme Corp. ``` *** ## get\_person Retrieve the complete profile for a specific person by their unique ID. Use this tool after a `search_people` call when you need fields that are not included in search results, such as phone number, LinkedIn URL, or timestamps. ### Parameters The unique ID of the person to retrieve. Obtain this from a `search_people` or `list_contacts` result. ### Returns A single full person object. Unique identifier for the person. Full name. Primary email address. Job title. Phone number. ID of the person's organization. Name of the person's organization. LinkedIn profile URL. ISO 8601 timestamp of when the contact was added to your workspace. ISO 8601 timestamp of the most recent update to this record. ### Example prompt ```text theme={null} Get full details for person ID abc123. ``` *** ## search\_organizations Search for organizations in your workspace by name or domain. Use this tool to find companies before looking up their members or passing an `organization_id` to `search_people`. ### Parameters The search string. Matched against organization name and domain. Example: `"acme.com"` or `"healthcare"`. Maximum number of results to return. Defaults to `10`. Maximum value is `100`. ### Returns An array of organization summary objects. Unique identifier for the organization. Use this with `get_organization` or as the `organization_id` filter in `search_people`. Organization name. Primary web domain (e.g. `acme.com`). Industry classification. Organization size or headcount range. ### Example prompt ```text theme={null} Find organizations in the healthcare industry. ``` *** ## get\_organization Retrieve full details for a specific organization by its ID. Optionally include its member list in the same response by setting `include_members` to `true`. ### Parameters The unique ID of the organization to retrieve. Obtain this from a `search_organizations` result. When set to `true`, the response includes a `members` array containing every person associated with the organization. Defaults to `false`. ### Returns A single organization object. When `include_members` is `true`, the `members` array is populated. Unique identifier for the organization. Organization name. Primary web domain. Industry classification. Organization size or headcount range. Array of person objects belonging to this organization. Only present when `include_members` is `true`. Each object contains the same fields as a `search_people` result. ### Example prompt ```text theme={null} Get Acme Corp's details and list all their people. ``` *** ## list\_contacts List all contacts in your workspace with support for pagination and sorting. Use this tool when you want to browse or export your full contact list rather than search for a specific person. ### Parameters Number of contacts to return per page. Defaults to `50`. Maximum value is `200`. Number of contacts to skip before returning results. Use together with `limit` to paginate through large lists. Defaults to `0`. Field to sort results by. Accepted values: * `name` — alphabetical by full name * `created_at` — most recently added first * `updated_at` — most recently modified first ### Returns A paginated response object. Array of person objects for the current page. Each object contains the same fields returned by `search_people`. Total number of contacts in your workspace, regardless of pagination. Use this with `limit` and `offset` to calculate how many pages exist. ### Example prompt ```text theme={null} List my 20 most recently added contacts. ``` To page through all contacts, start with `offset: 0` and increment by your `limit` value on each subsequent call until the number of returned contacts is less than `limit`, or until `offset` exceeds `total`.