> ## 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.

# Frequently asked questions about peeps and the MCP server

> Answers to common questions about the peeps MCP server: what it is, supported AI clients, installation, data security, rate limits, and billing.

Here are answers to the most common questions about peeps and the peeps MCP server. If you don't find what you're looking for, reach out to [support@peeps.ai](mailto:support@peeps.ai).

## Getting Started

<Accordion title="What is peeps?">
  peeps is a B2B SaaS platform that gives your AI assistant access to your people and contact data via the Model Context Protocol (MCP). Connect once and your AI can search contacts, look up people, and find organization details — all without leaving your chat interface.
</Accordion>

<Accordion title="What AI clients does peeps support?">
  peeps works with any MCP-compatible client. This includes:

  * **Claude Desktop** (macOS and Windows)
  * **Cursor**
  * Any agent framework that supports MCP over stdio or HTTP/SSE transport

  See the Integrations section of the docs for step-by-step setup guides for each client.
</Accordion>

<Accordion title="Do I need to install anything?">
  It depends on how you connect:

  * **Local clients (Claude Desktop, Cursor):** You need Node.js 18 or later. You can then run the server on demand with `npx` — no separate install step required:

    ```bash theme={null}
    npx -y @peeps-ai/mcp
    ```

  * **Remote or cloud agents:** Connect directly to `https://mcp.peeps.ai/sse` using your API key. No local installation needed.
</Accordion>

## Data & Security

<Accordion title="Where is my people data stored?">
  Your data is stored securely in the peeps cloud. The MCP server retrieves data in real time when your AI assistant makes a tool call — nothing is cached locally on your machine.
</Accordion>

<Accordion title="Is my data shared with AI providers?">
  Only the data you explicitly query is sent to your AI assistant as part of tool responses. peeps does not proactively share your data with any AI provider. Your AI only sees the records returned by the specific search or lookup it performed.
</Accordion>

<Accordion title="How are API keys secured?">
  API keys are hashed and stored securely — the raw key value is never retained after creation. You can revoke any key at any time from the [peeps dashboard](https://app.peeps.ai).

  <Warning>
    Never commit your API key to version control. Use environment variables or a secrets manager to keep it out of your codebase.
  </Warning>
</Accordion>

## Features & Limits

<Accordion title="What data can the peeps MCP server access?">
  The peeps MCP server can search and retrieve:

  * **People records** — name, email address, job title, phone number, and LinkedIn profile
  * **Organization records** — company name, domain, and related metadata
  * **Workspace contacts** — the contacts synced to your peeps workspace

  The exact fields available depend on the data in your workspace and the permissions of your API key.
</Accordion>

<Accordion title="Are there rate limits?">
  Yes. Specific rate limits depend on your plan. If you exceed your limit, the server returns a `429 Too Many Requests` error. Wait a moment and retry the request.

  If you consistently hit rate limits and need higher throughput, contact [support@peeps.ai](mailto:support@peeps.ai) to discuss your options.
</Accordion>

<Accordion title="Can I use peeps with multiple AI clients at the same time?">
  Yes. You can configure peeps in Claude Desktop, Cursor, and other MCP-compatible clients simultaneously. All clients can use the same API key — each will make independent requests to the peeps server.
</Accordion>

## Billing & Plans

<Accordion title="Is there a free plan?">
  Yes, peeps offers a free tier so you can get started without a credit card. Visit [app.peeps.ai](https://app.peeps.ai) to see the current plan options and what's included in each tier.
</Accordion>

<Accordion title="How do I cancel or change my plan?">
  You can upgrade, downgrade, or cancel your subscription at any time from the **Billing** section of the peeps dashboard at [app.peeps.ai](https://app.peeps.ai). Changes take effect at the start of your next billing cycle.
</Accordion>

<Card title="Have a specific error? Check the troubleshooting guide." href="/troubleshooting">
  Step-by-step solutions for the most common issues when connecting the peeps MCP server to your AI client.
</Card>