mdbase MCP

Tool reference

Every tool offered by mdbase MCP 0.1.0-beta.126, with its inputs.

This page is generated from the tool definitions in the MCP server, so the names, descriptions and inputs match what your client receives. Inputs marked optional can be left out.

Always available

Offered to every client. Tools that act on a collection still need the matching operation approved for it.

`list_connections`

List the mdbase collections approved for this connector. Use the returned connection_id on every collection operation.

List mdbase collections · Read-only

No inputs.

`add_connection`

Create a short-lived browser link where the user can explicitly approve another collection and its permissions.

Connect another mdbase collection · Returns a browser link

No inputs.

`reconnect_collection`

Create a short-lived browser link that preselects one existing collection so the user can renew or broaden its approval.

Reconnect an mdbase collection · Returns a browser link

Input	Type	Notes
`connection_id`	UUID	Opaque connection ID returned by list_connections

`describe_collection`

Return collection metadata, supported operations, types and contracts.

Describe an mdbase collection · Read-only

Input	Type	Notes
`connection_id`	UUID	Opaque connection ID returned by list_connections

`list_changes`

List changes after an optional collection change cursor.

List collection changes · Read-only

Input	Type	Notes
`connection_id`	UUID	Opaque connection ID returned by list_connections
`after` (optional)	integer (≥ 0)
`limit` (optional)	integer (≥ 1, ≤ 200)

`query_records`

Query records in one approved collection. Filters use the collection's native mdbase query format.

Query mdbase records · Read-only

Input	Type	Notes
`connection_id`	UUID	Opaque connection ID returned by list_connections
`types` (optional)	string[]
`timezone` (optional)	string
`context` (optional)	any
`projections` (optional)	any
`where` (optional)	any
`select` (optional)	any
`order_by` (optional)	any
`group_by` (optional)	any
`summary_functions` (optional)	any
`summaries` (optional)	any
`limit` (optional)	integer (≥ 1, ≤ 1000)
`offset` (optional)	integer (≥ 0)
`pagination` (optional)	"cursor"
`cursor` (optional)	string	Opaque hosted query cursor
`snapshot` (optional)	string
`include_body` (optional)	boolean
`frontmatter_mode` (optional)	"effective" \| "persisted" \| "both"
`contract` (optional)	any

`release_query_cursor`

Release an unfinished hosted query cursor promptly instead of waiting for bounded expiry.

Release an mdbase query cursor · Read-only

Input	Type	Notes
`connection_id`	UUID	Opaque connection ID returned by list_connections
`cursor`	string	Opaque hosted query cursor

`read_record`

Read one record by its collection-relative path.

Read an mdbase record · Read-only

Input	Type	Notes
`connection_id`	UUID	Opaque connection ID returned by list_connections
`path`	string	Collection-relative record path

`validate_collection`

Run collection validation. Optional input is passed to the collection's validation operation.

Validate an mdbase collection · Read-only

Input	Type	Notes
`connection_id`	UUID	Opaque connection ID returned by list_connections
`input` (optional)	object

`read_type`

Read a type definition by name or collection-relative path.

Read an mdbase type · Read-only

Input	Type	Notes
`connection_id`	UUID	Opaque connection ID returned by list_connections
`name` (optional)	string
`path` (optional)	string	Collection-relative record path

Write tools

Offered only when the client's sign-in scope includes mdbase:write.

`create_record`

Create a record in one approved collection.

Create an mdbase record · Changes the collection

Input	Type	Notes
`connection_id`	UUID	Opaque connection ID returned by list_connections
`path` (optional)	string	Collection-relative record path
`type` (optional)	string
`frontmatter` (optional)	object
`body` (optional)	string
`if_revision` (optional)	string
`mutation_id` (optional)	UUID

`update_record`

Partially update a record. Supply if_revision when available to prevent overwriting a concurrent edit.

Update an mdbase record · Changes the collection

Input	Type	Notes
`connection_id`	UUID	Opaque connection ID returned by list_connections
`path`	string	Collection-relative record path
`patch` (optional)	object
`body` (optional)	string
`document` (optional)	string
`if_revision` (optional)	string
`mutation_id` (optional)	UUID

`delete_record`

Delete one record. Supply if_revision when available and check_backlinks before removing referenced records.

Delete an mdbase record · Destructive

Input	Type	Notes
`connection_id`	UUID	Opaque connection ID returned by list_connections
`path`	string	Collection-relative record path
`check_backlinks` (optional)	boolean
`if_revision` (optional)	string
`mutation_id` (optional)	UUID

`rename_record`

Rename or move a record within its collection and optionally update references.

Rename an mdbase record · Changes the collection

Input	Type	Notes
`connection_id`	UUID	Opaque connection ID returned by list_connections
`from`	string	Collection-relative record path
`to`	string	Collection-relative record path
`update_refs` (optional)	boolean
`if_revision` (optional)	string
`mutation_id` (optional)	UUID

`create_type`

Create a portable mdbase type definition in an approved collection.

Create an mdbase type · Changes the collection

Input	Type	Notes
`connection_id`	UUID	Opaque connection ID returned by list_connections
`document`	string
`path` (optional)	string	Collection-relative record path
`mutation_id` (optional)	UUID

`update_type`

Update a portable mdbase type definition using its current revision.

Update an mdbase type · Changes the collection

Input	Type	Notes
`connection_id`	UUID	Opaque connection ID returned by list_connections
`name` (optional)	string
`path` (optional)	string	Collection-relative record path
`document`	string
`if_revision`	string
`mutation_id` (optional)	UUID