Helpcentrum

Agent-Readable Export (OKF)

The Open Knowledge Format (OKF) export turns your Peerdom organization into a set of plain, linked documents that AI agents can read directly — your circles, roles, people, goals, and pages, described in a shape any agent understands. It speaks the Open Knowledge Format, an open standard for sharing organizational knowledge with AI agents, so an agent can understand how your organization works without a custom integration.

It’s the open, readable companion to the MCP server: MCP lets an assistant talk to your organization on your API key; OKF makes your organization legible to any agent that can read a file.

Make your map public and its OKF bundle is published automatically — readable by any agent, with no key or setup. For private organizations, the export stays behind your door and is available to Owners only.

What’s in the bundle

An OKF bundle is a folder of Markdown files — one file per “concept” — that link to one another to describe your organization:

Your Peerdom dataBecomes a concept of typeAn agent can tell
CircleCirclewhich teams exist, how they nest, what they’re accountable for
RoleRoleeach role’s purpose, which circle it belongs to, who fills it
PersonPeerwhich roles someone holds and where
GoalGoalwhat an outcome is and which role or circle owns it
PagePagethe supporting context you’ve published

The bundle opens with an index that lets an agent see the whole organization at a glance and then follow links into the detail. Everything is written in your own vocabulary — if you’ve renamed circles to “teams” or “pods,” the bundle uses your terms.

Make your map public → instantly agent-readable

If your organization’s map is public, its OKF bundle is published at a stable, open address and kept up to date as your organization changes. Any agent — Claude, ChatGPT, Gemini, an open-source agent, anything that can fetch a URL — can read it and answer questions about your organization faithfully, with no integration on either side.

This is the simplest way to let the agentic web understand your organization: turn your map public, and you’re done.

What an agent can do with it

Pointed at your bundle, an agent can:

  • Summarize how your organization is structured, circle by circle.
  • Explain what a given role is for and who currently holds it.
  • Identify which roles sit empty, or who carries the most.
  • Trace how goals map to the roles and circles accountable for them.
  • Answer a newcomer’s “who do I talk to about X?” from the actual structure.

What’s included, and what isn’t

The bundle respects the same privacy choices as your public map:

  • Only public pages are included.
  • People appear only if you show them. If your public map and embeds hide peer details, the bundle describes structure without naming individuals.
  • Archived items are left out.
A public OKF bundle exposes exactly what your public map already exposes — nothing more. If something shouldn't be public, keep your map private and use the authenticated export or the MCP server instead.

Private organizations

If your organization isn’t public, its bundle isn’t published to an open address. Its complete export stays available to Owners through an authenticated request, which ignores the public gates and includes everything. For live, conversational access to a private organization, the MCP server is usually the better fit: it answers questions on demand rather than handing over a static snapshot.

Frequently asked questions

What is OKF?

The Open Knowledge Format is an open standard for describing knowledge — including organizational structure — as a folder of linked Markdown files that both people and AI agents can read. It needs no SDK, account, or proprietary tooling.

How is this different from the MCP server?

The MCP server is a live, authenticated connection: an assistant asks questions on your API key and gets answers in real time. The OKF export is an open, readable artifact: a snapshot of your organization that any agent can read, ideal for public maps. Many organizations will use both.

Do I need to set anything up for a public map?

No. When your map is public, the bundle is published and kept current automatically.

Can an agent change my organization through the bundle?

No. OKF is read-only by nature — it’s a description an agent reads, never a way to edit your organization.

Does this require a specific Peerdom plan?

The public bundle is published automatically for any public map. The authenticated full export for private organizations is available to organization Owners. For questions about your plan, contact Peerdom support.