Standards

View saved version →

---
name: standards
description: Standards workspace work through the `standards` MCP tools — answering a question from workspace data, counting or totalling records, creating or updating records, reading or filing documents attached to a record, recalling or proposing workspace memory.
---

# Standards

## What Standards is

Standards ([standards.new](https://standards.new)) is a business workspace — CRM, documents, drives, email, forms and AI agents in one app — whose data model is declared, not fixed. Each team shapes its own: a sales team's workspace holds `contacts`, `companies` and `deals`, an operations team's holds `incidents` and `suppliers`. The `standards` MCP server opens exactly one workspace, with the rights of the member who connected.

| Word | Meaning |
|---|---|
| Workspace | One tenant: its schema, records, members, memory. Your connection is bound to one. |
| Object | A type of record, kebab-case and usually plural (`contacts`, `deals`). Declared in code or created by a member in the app, so the list differs per workspace. |
| Attribute | A typed field on an object: text, richtext, number, checkbox, date, phone, currency, status, select, multiselect, location, user, relation, and a few more. Validated on every write. |
| Record | One row of an object: a UUID, timestamps, a `version`, and its attributes. |
| Document | A titled pack of files, always attached to one record, filed in that record's drive (folders + documents). |
| Memory | Pages the workspace keeps about itself, each member, each record and recurring topics. Written by the workspace; agents read and propose. |
| Role | What the connected member may read, create, update, delete, per object. Your tool list is already narrowed to it. |

**The schema is the contract.** Members add attributes, objects and select options in the app at any time, so the schema you saw yesterday is a guess today. Every attribute name, type, required field and select option comes from reading `schema:<object>` in this session.

## Tools and references

Eight tools at most: `search`, `query`, `read`, `write`, `edit_content`, `organize`, `delete`, `propose_memory`. All but `query` and `propose_memory` name things by **reference**, `<kind>:<id>`:

| Reference | Read it for |
|---|---|
| `record:<uuid>` | The record and its `version`; `include: ["memory"]` adds its memory page, `include: ["drive"]` its folders and files. |
| `document:<uuid>` | Metadata, files and extracted text. |
| `file:<uuid>` | A signed download `url`, valid 5 minutes. |
| `schema:<object>` / `schema:*` | Attributes, types, required fields, select options and views / every object you can read. |
| `memory:<name>` / `memory:*` | One memory page / the workspace profile and your own. |
| `user:<id>` | A workspace member (only with people access). |
| `guide:<kind>` | The full contract of a kind, with its pitfalls: `guide:record`, `guide:document`. |

`search` returns references as each hit's `id`, so a hit goes straight into `read`. A bare id is refused with `REFERENCE_INVALID`: prefix it.

## Orient before the first action

1. Read the server's handshake `instructions`: they list every object you can read, with its label and description. Map the user's words ("clients", "dossiers", "foyers") onto those object names.
2. `read` with `refs: ["memory:*"]`: the workspace profile and the connected member's profile — vocabulary, conventions, who is who.
3. `read` the `schema:<object>` of each object you are about to filter or write, in one call (`refs` takes up to 50).

Done when every object you will touch is named exactly as the handshake names it, and you hold its schema from this session.

## Reading

Two ways to find records, and they answer different questions:

- **Exact** — `query` with an `object` and `filters`. A complete read of the database: use it for "every deal in status Won", "contacts in 69003", anything you will list or count. Up to 1000 rows per call; paginate with `offset` until `hasMore` is 

Preview of the first 4,000 characters. Read full instructions →