mcpField
N
notis-query

notis-query

github.com/mindthefloData & databases0177 installsUpdated today
Repository

About notis-query

notis-query is a skill for using structured native queries against Notis databases. It helps users inspect schemas, retrieve complete paginated results, and handle records and writes with revision-aware safeguards.

Key features

  1. 01Inspect database schemas and targets
  2. 02Filter, sort, aggregate, and paginate
  3. 03Continue queries through all pages
  4. 04Read linked records and views
  5. 05Safeguard writes with revisions and readback

Use cases

  1. 01Find records matching field criteria
  2. 02Compute counts or aggregates
  3. 03Retrieve all pages of a database query
  4. 04Update a record and verify the result

MCP support

The skill documents querying through Notis native database tools, including database discovery, query, and write operations. Hosted MCP provides related reference guides.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/mindtheflo/notis-skills --skill notis-query

After installing, type/notis-queryin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
database-discovery.md
documents.md
query.md

Details

From the project README

Native database queries

Use structured native queries for filtering, sorting, counts, aggregates and pagination. Use memory for semantic discovery; use view rendering for what a page shows. The live tool inputSchema is authoritative.

  1. Discover the database and inspect its schema, property descriptions, relation targets and option IDs with LOCAL_NOTIS_DATABASE_GET_DATABASE.
  2. Keep its exact returned native target, schema revision and available operations. Every database lives in a Space; failed access never falls back to another owner.
  3. Use LOCAL_NOTIS_DATABASE_QUERY with protocol: 1, that target and direct input. Build filters from actual field types/options. Page until the returned continuation ends; one page is not the whole database.
  4. For a known record or view link, follow Reading records instead of running broad discovery. View links come from write results or LOCAL_NOTIS_FIND_VIEWS; sensitive or stale evidence needs a fresh render.
  5. Writes use discovered native tools with current schema/record revisions and a stable request ID. Dry-run first and read back the committed state. A missing view link is not a failed write and does not justify repeating it.

In authored Space code use useShown or declared actions, not account-wide tool calls. Load notis-spaces for Space authoring; its hosted reference is notis://docs/notis-spaces/references/views.md.

Guides

Hosted MCP exposes these references under notis://docs/notis-query/references/<file>.md; load only the relevant guide.

Comments

Markdown supported