yarnnnyarnnn
yarnnn for developers

Build on durable, attributed memory

yarnnn exposes a Model Context Protocol (MCP) server so any MCP-capable assistant can read and write a user's shared memory — with full provenance. Everything you need to connect an agent is below, at predictable URLs.

Authentication is OAuth 2.1. The machine-readable contract lives at yarnnn.com/openapi.json.

Developer resources

MCP connector

↗

The Model Context Protocol server. Connect any MCP-capable assistant — ChatGPT, Claude, and others — to read and write yarnnn memory directly.

Transport: streamable-http · Auth: OAuth 2.1

OpenAPI specification

→

The machine-readable API contract (OpenAPI 3.1). Describes yarnnn's agent-facing verbs — remember, recall, trace — with request and response schemas.

GET /openapi.json

MCP discovery card

→

The website→server breadcrumb. Advertises the MCP server, its transport, OAuth metadata location, and tool list so agents can auto-discover the connector.

GET /.well-known/mcp.json

OAuth 2.1 authorization metadata

↗

The authorization-server metadata for the MCP connector. Standard OAuth 2.1 discovery — endpoints, supported grants, and scopes.

GET /.well-known/oauth-authorization-server

llms.txt

→

A plain-text summary of yarnnn for language models — what the product is, how to connect over MCP, and where the key resources live.

GET /llms.txt

Product docs

↗

Human-facing documentation — concepts, the substrate model, and guides for getting the most out of yarnnn.

GitBook

The memory API — three verbs

The whole surface an agent calls. Documented in full in the OpenAPI spec.

remember

remember(content, about?)

Save something worth keeping — a decision, fact, or preference. The write is synchronous and durable: the moment it returns, the memory is stored, attributed, and retrievable.

recall

recall(subject, question?, domain?, limit?)

Pull what the user already knows about a subject. Returns the stored material plus a confidence signal; the host assistant explains it.

trace

trace(subject, limit?)

Show how a recorded fact changed over time — who changed it, when, and what changed. The capability a plain storage connector cannot show.

Connect an agent to yarnnn

Point your MCP-capable assistant at the connector and authorize over OAuth 2.1. It can read and write memory immediately.

MCP connectorView the OpenAPI spec