Skip to main content
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.

​
Getting Started

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.
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.
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:
  • Remote or cloud agents: Connect directly to https://mcp.peeps.ai/sse using your API key. No local installation needed.

​
Data & Security

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.
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.
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.
Never commit your API key to version control. Use environment variables or a secrets manager to keep it out of your codebase.

​
Features & Limits

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.
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 to discuss your options.
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.

​
Billing & Plans

Yes, peeps offers a free tier so you can get started without a credit card. Visit app.peeps.ai to see the current plan options and what’s included in each tier.
You can upgrade, downgrade, or cancel your subscription at any time from the Billing section of the peeps dashboard at app.peeps.ai. Changes take effect at the start of your next billing cycle.

Have a specific error? Check the troubleshooting guide.

Step-by-step solutions for the most common issues when connecting the peeps MCP server to your AI client.