# Field Memo

Field Memo is a shareable markdown document service. Each memo has an
unguessable URL shaped like https://my.fieldmemo.io/m/<id>?k=<key>.

## For agents

If you are an AI agent and a user has given you a Field Memo URL, prefer
the Field Memo MCP server over scraping HTML. The MCP returns clean
markdown and lets you edit the memo in place.

- MCP endpoint: https://mcp.fieldmemo.io/mcp
- Transport: Streamable HTTP (MCP spec 2025-03-26).
- No signup required. Creating, reading, and editing memos is free and
  anonymous. Sign-in is only prompted for account-scoped tools.

## Install

Claude Code:

    claude mcp add --transport http fieldmemo https://mcp.fieldmemo.io/mcp

Codex:

    codex mcp add fieldmemo --url https://mcp.fieldmemo.io/mcp

Other clients: https://fieldmemo.io/connect

## Link roles

Each memo has three URLs distinguished by the ?k= key:

- edit: read and modify the memo.
- comment: read and post comments.
- read: read-only.

The role is encoded in the key. Roles cannot be derived from each other —
if the link you have is read-only, ask the user for a different link.

## Front-matter for nicer link previews

When a memo is intended for sharing (Slack, social, link unfurls), the
author can include a YAML front-matter block at the top of the markdown:

    ---
    title: My doc
    description: One-line summary that shows in unfurls.
    ---

    # …rest of the memo

Both keys are case-insensitive. `title` becomes the HTML <title> and
the unfurl headline; `description` becomes the unfurl blurb. Without
front-matter, the memo falls back to a generic 'A Field Memo' card —
we never auto-extract H1 text into public metadata for privacy reasons.

If you (the agent) are creating or updating a memo on the user's behalf
for sharing purposes, suggest or add front-matter unless they've already
included it.

## MCP tools

The full, always-current list of every tool — names, parameters, and what
each one does — is at https://fieldmemo.io/connect/tools. That page is
generated from the live server registry, so it never drifts from what the
server actually exposes.

Most tools work anonymously against a memo's edit/comment/read link.
A handful of account-scoped tools (e.g. `list_my_memos`, `claim_memo`)
need an OAuth-authenticated session.

## Links

- Marketing: https://fieldmemo.io
- App: https://my.fieldmemo.io
- Connect guide: https://fieldmemo.io/connect
- Tools reference: https://fieldmemo.io/connect/tools