Examples

Start with a useful, read-only request.

The public examples show how to fetch a relationship briefing or connect through the MCP SDK. Run them against records you own or are authorized to access.

Node

A client using the official MCP TypeScript SDK. Follow its README for configuration and credentials.

Open Node example →

Framework adapters

The ppl-memory package provides adapters for agent frameworks. Check the package documentation for supported versions.

Open ppl-memory →

A briefing over REST

Supply your token through a secure environment or credential store, then request:

GET https://withppl.com/api/agent/briefing
Authorization: Bearer <your private token>

With MCP, discover tools/list and use agent.briefing.get. For a specific person, resolve their identity before calling contacts.digest.get. Tool availability depends on the connection’s scopes.

Give the result a clear next step

A birthday or overdue follow-up is context for a suggestion. Let the user choose what happens next. If your workflow requests a message draft, report it as a draft until the server confirms execution.

Build a daily relationship routine · Check a contact CSV locally