# person-mcp

> Relationship memory for your AI agent: an MCP server that remembers the people you meet.

- Documentation: https://person-mcp.thally.app
- GitHub: https://github.com/nicolasarnedo99/person-mcp-docs
- Full docs for LLMs: https://person-mcp.thally.app/llms-full.txt
- Agent discovery (ai.txt): https://person-mcp.thally.app/ai.txt
- Structured docs index (JSON): https://person-mcp.thally.app/api/docs-index
- OpenAPI spec: https://person-mcp.thally.app/openapi.yaml

## For AI agents

Every page supports content negotiation on its human URL:
- JSON API: append `?format=json` or send `Accept: application/json`
- JSON-LD: append `?format=ldjson` or send `Accept: application/ld+json`
- Markdown: append `?format=md` or send `Accept: text/markdown`
- Per-page API: https://person-mcp.thally.app/api/docs/{page-id}
- Search API: https://person-mcp.thally.app/api/search?q={query}
- Capability manifest (skill): https://person-mcp.thally.app/skill.md
- Agent guidance (editing these docs): https://person-mcp.thally.app/AGENTS.md
- MCP server (attach docs as native tools): https://person-mcp.thally.app/api/mcp
- Agent readiness: https://person-mcp.thally.app/api/agent-readiness
- Changelog feed (JSON Feed): https://person-mcp.thally.app/changelog/feed.json
- Changelog feed (RSS): https://person-mcp.thally.app/changelog/rss.xml

### Recommended workflow

1. Use this index, the search API, or `search_sections` / `search_docs` before choosing a page.
2. Read the smallest set of relevant pages and follow their prerequisite links.
3. Treat the published docs as the source of truth. Label inferences and say when evidence is missing.
4. Cite the canonical human page URLs, not only API endpoints.
5. Use `/AGENTS.md` before editing a repository. The public MCP server is read-only.

## Get started

### Get started

- [Introduction](https://person-mcp.thally.app/): person-mcp gives your AI agent a memory of the people you meet, stored in a JSON file on your own disk.
- [Quickstart](https://person-mcp.thally.app/quickstart): Run person-mcp locally, connect it to Claude Code, and get your first answer from the store in about five minutes.

## Guides

### Use person-mcp

- [Prepare for a call with person-mcp](https://person-mcp.thally.app/guides/prep-before-a-call): Import a contact from a profile you just read, log each touchpoint, and get a one-message briefing before you talk to them.

## Reference

### Reference

- [Tool reference](https://person-mcp.thally.app/reference/tools): Every person-mcp tool, its parameters and what it returns.

## Changelog

- [Changelog](https://person-mcp.thally.app/changelog): Changes to person-mcp that affect how you install or use it.