You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
memos/proto/api/v1
boojack 047175dbed chore(mcp): improve tool discoverability, add orientation tools and evals
Make the OpenAPI-driven MCP surface more usable by agents, following the
mcp-builder guidance.

- Enrich proto descriptions (single source of truth, flows to OpenAPI + MCP
  tool descriptions): document the memo `filter` CEL grammar with fields and
  examples (replacing the dangling "Refer to Shortcut.filter"), clarify the
  created_ts/updated_ts vs create_time/update_time naming, the visibility
  enum, the declarative replace semantics of Set* ops, and steer tag filters
  to `"x" in tags` (not the unsupported `tag == "x"`).
- Mark SetMemoAttachments / SetMemoRelations idempotent via a per-operation
  override the HTTP-method heuristic can't express.
- Curate two read-only orientation tools: shortcut_list_shortcuts (surfaces
  reusable CEL filters) and auth_get_current_user (the single allowed
  auth/identity op, for resolving the current user); guard test updated to
  keep the rest of the auth/user surface excluded.
- Add a task-level evaluation suite (server/router/mcp/evals) with 10
  verified questions, pinned to the deterministic demo seed.
2 weeks ago
..
README.md chore: update demo site 1 year ago
ai_service.proto feat(transcription): explicit STT settings with provider, model, prompt (#5926) 2 months ago
attachment_service.proto feat(attachments): add Live Photo and Motion Photo support (#5810) 3 months ago
auth_service.proto feat: replace auto-increment ID with UID for identity provider resource names (#5687) 4 months ago
common.proto refactor: renovate list memos endpoint 1 year ago
idp_service.proto chore: standardize and improve API structure (#5224) 8 months ago
instance_service.proto feat(storage): add insecure_skip_tls_verify option for S3 2 weeks ago
memo_service.proto chore(mcp): improve tool discoverability, add orientation tools and evals 2 weeks ago
shortcut_service.proto chore(mcp): improve tool discoverability, add orientation tools and evals 2 weeks ago
user_service.proto chore(webhook): reveal-later signing secret flow 2 weeks ago

README.md

Memos API Design

This API design should follow the guidelines and best practices outlined in the Google API Improvement Proposals (AIPs).