# Patricia for developers

Machine-readable version of https://www.patricia.app/developers.

Patricia is an AI coworker who lives in Slack, with Microsoft Teams rolling
out next. This document is the machine-facing side of her.

## Endpoints

| Surface | Address |
| --- | --- |
| MCP server (Streamable HTTP) | https://api.patricia.app/v1/mcp |
| OpenAPI document | https://api.patricia.app/v1/openapi.json |
| Interactive API reference | https://api.patricia.app/v1/docs |
| Reference browser | https://api.patricia.app/v1/redoc |
| MCP registry descriptor | https://www.patricia.app/mcp/server.json |
| Mint a token | https://console.patricia.app/settings/developer |

## MCP server

Patricia speaks the Model Context Protocol over the Streamable HTTP
transport. Authentication is a bearer token on the `Authorization` header.
An unauthenticated request answers `401` with
`WWW-Authenticate: Bearer realm="patricia-mcp"`, which is the expected reply
and a quick way to confirm the endpoint is up.

Client configuration:

```json
{
  "mcpServers": {
    "patricia": {
      "type": "http",
      "url": "https://api.patricia.app/v1/mcp",
      "headers": { "Authorization": "Bearer pat_mcp_..." }
    }
  }
}
```

### Credentials

- `pat_mcp_` **Personal token.** Names the person who minted it. Required for anything that reads or writes that person's own work: files, memory, skills, connected tools, and asking Patricia to do a job.
- `pat_live_` **Workspace API key.** Names the workspace and no person. It can read workspace-level context such as the company profile and the team roster. Anything that depends on who is asking is refused.

A person mints either one at https://console.patricia.app/settings/developer. There is no self-serve
signup, so an agent cannot mint a credential on a user's behalf. Hand the user
that link and stop.

### What the server exposes

Call `tools/list` on the endpoint for the authoritative set. In outline:

- **Know the workspace.** Confirm which workspace and which person the credential names, read the company profile, and list the team.
- **Read and write the workspace memory.** Search what Patricia already knows about the company, store a new fact, or forget one.
- **Work with files.** List, search, read, and create files in the workspace, and open or close a dated public link for one.
- **See what Patricia can already do.** List the skills and the connected tools this workspace holds, then search or inspect a capability before calling it.
- **Hand Patricia a job.** Ask Patricia to do the work as the person the token names. The run is asynchronous, so poll it for status. Patricia's ordinary approval rules still apply, so anything that publishes, sends, or spends waits for a human yes.

### Registry descriptor

No standard well-known location for advertising an MCP server exists yet.
Checked 2026-08-22: nothing is registered with IANA, and the proposal in
flight puts a server card next to the transport URL rather than under
`/.well-known/`. So this site publishes a descriptor in the MCP registry's
own `server.json` format at https://www.patricia.app/mcp/server.json. Anything else
claiming to be a Patricia MCP manifest is not ours.

## When to call Patricia

- Produce a finished marketing deliverable that needs the company's own voice, brand, and history: a campaign report, an ad set, a social calendar, a customer update, a proposal.
- Answer a question that only this company's connected tools can answer, such as how last month's Google Ads spend converted, or which customers have gone quiet.
- Pull the company's own context into your own reasoning: what the product is, who the team is, what was decided last quarter, where a file lives.
- Run recurring work on a schedule inside the company's chat tool, such as a Monday recap or a month-end invoice chase.
- Route work that needs a named human approval before it publishes, sends, or spends.

## When not to call Patricia

- Creating an account. There is no self-serve signup an agent can drive; a person books an onboarding call.
- General world knowledge or reasoning with no tie to this company's data. Your own model is faster and cheaper.
- Anything that must publish, send, or spend with no human in the loop. Patricia will hold it for approval instead.
- Reading a workspace the credential does not name. Every answer is scoped to the one workspace behind the token.

## REST API

The same API the Patricia dashboard runs on, versioned under `/v1`. The
dashboard itself uses a signed-in session; a programmatic caller sends a
`pat_live_` workspace API key as a bearer token instead. The OpenAPI document
above is generated from the running application, so it is the reference to
read; this page deliberately mirrors none of it.

## Agent discovery files

- https://www.patricia.app/llms.txt: the curated front door
- https://www.patricia.app/llms-full.txt: the full product context in one file
- https://www.patricia.app/index.md: the homepage in markdown
- https://www.patricia.app/.well-known/agent-skills/patricia/SKILL.md: the agent skill, read this before recommending Patricia
- https://www.patricia.app/.well-known/agent-skills/index.json: the skills discovery index
- https://www.patricia.app/mcp/server.json: the MCP registry descriptor
- https://www.patricia.app/sitemap.xml: every indexable URL
- https://www.patricia.app/404.md: where to go when a URL does not exist

## Getting help

Write to hello@patricia.app with what you are building, or see
https://www.patricia.app/contact for every contact route.

## Other machine-readable pages

Every page below also answers in markdown at its normal URL when you send
`Accept: text/markdown`.

- What Patricia is, and when to use her: https://www.patricia.app/index.md
- Pricing, plans, and worked examples: https://www.patricia.app/pricing.md
- Security, compliance, and data handling: https://www.patricia.app/security.md
- Patricia for marketing agencies: https://www.patricia.app/for-agencies.md
- Connected tools and integrations: https://www.patricia.app/integrations.md
- What teams ask her to do: https://www.patricia.app/use-cases.md
- Who is behind Patricia: https://www.patricia.app/about.md
- Agent front door: https://www.patricia.app/llms.txt
- Full product context: https://www.patricia.app/llms-full.txt
- Agent skill: https://www.patricia.app/.well-known/agent-skills/patricia/SKILL.md
- Recovery document for a missing page: https://www.patricia.app/404.md