Query Markup Documents - On-device hybrid search for markdown files with BM25, vector search, and LLM reranking
Nothing to run from here
Commons is installed from its publisher's own source and answers where it runs, so this marketplace is not in the path of a single call. There is no address here to send one to, and a panel that pretended otherwise would be showing you an answer we made up. Install it and call it from your own client — the Installation tab has the entry for each one.
34
tools declared
—
trust score
local
runs on your machine
—
calls last 7d
What it does
Shared memory, work claims and handoffs so parallel AI coding sessions stop colliding.
Quickstart
# 1 — add it to Claude Code
claude mcp add --scope user commons-mcp '--' docker run -i --rm -v commons-data:/data ghcr.io/neoo-blue/commons-memory serve --transport stdio
# 2 — ask your agent for something these tools do
# remember, restrict, unrestrict and 31 more
Commons costs nothing on mcprush: there is no plan to choose here, no cap to set and nothing mcprush can bill you for.
Publishernot claimed
NBAll 1 server
Neoo-Blue1 server
1 category
Collected from a public index. Nobody has claimed this account, so nothing here was written by its author — claim it if it is yours.
Installation
Where are you running it?
Every route below installs the same thing and ends at the same approval screen. This one runs on your machine: your client starts Commons as a process under your own user, with your files and your network, so the tool surface below is what it can do to your computer rather than to a server somewhere else. It has not been scanned here, so read the surface, and its source, before you approve it.
Claude Codedeclared by this listing
This is a public server: you run it yourself and this marketplace is not in the path. You need Docker installed and running. Only the required variables are passed into the container. To set an optional one (COMMONS_AGENT, COMMONS_TOOLS), add -e NAME before the image name and give it a value in the entry’s env: an unset -e would clear the default the image sets. Claude Code registers it in one command; --scope user makes it available in every project. The '--' is in quotes so that PowerShell passes it on.
claude mcp add --scope user commons-mcp '--' docker run -i --rm -v commons-data:/data ghcr.io/neoo-blue/commons-memory serve --transport stdioReconnect, or start a new session, and the tools appear in the model’s tool list.
Free on mcprush, and it runs from its publisher’s own image: this marketplace is not in the path, so there is no key of ours to hold and no card to add.
What it asks of you
Nothing is required, but it can take COMMONS_AGENT (Name this client goes by in Commons), COMMONS_TOOLS (Tool listing: lite, core or all) if you want to set them.
What it writes
One config entry your client uses to start the process locally. A local server runs with your file system and your network, which is why it is priced without metering.
What you approve
34 tools, with what each one reads, writes and reaches shown before you agree — the same list on every route above. Read the tool surface.
Tool surface
What the model actually sees. Descriptions are diffed on every release — see version history.
Store a memory (note, observation, fact). content is the text (text and fact are accepted as aliases).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| content | string | no | — |
| title | string | no | — |
| project | string | no | — |
| tags | array | no | — |
| entities | array | no | — |
| kind | string | no | — |
| related_ids | array | no | — |
| subject | string | no | — |
| predicate | string | no | — |
| value | string | no | — |
| session_id | string | no | — |
| text | string | no | — |
| visible_to | array | no | — |
| fact | string | no | — |
| agent | string | no | — |
| api_key | string | no | — |
Limit one record (memory, decision, board item, Drive file) to the named agents; perm write also lets them change it. You (its author) and admins keep access. unrestrict(id) opens it again.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| id | string | yes | — |
| agents | array | yes | — |
| perm | string | no | — |
| agent | string | no | — |
| api_key | string | no | — |
Make a restricted record visible again to everyone who can read its project.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| id | string | yes | — |
| agent | string | no | — |
| api_key | string | no | — |
Hybrid search (keyword + meaning, entities, time, recency). Returns one-line hits with ids; expand(id) for detail. context=N adds the N neighbouring turns of each hit. Filters: project, agent_filter, tags, kinds, entity, since/until (ISO or 7d/12h); as_of = reference time for relative dates;…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| query | string | no | — |
| mode | string | no | — |
| project | string | no | — |
| agent_filter | string | no | — |
| tags | array | no | — |
| kinds | array | no | — |
| entity | string | no | — |
| since | string | no | — |
| until | string | no | — |
| limit | integer | no | — |
| max_tokens | integer | no | — |
| format | string | no | — |
| as_of | string | no | — |
| rerank | boolean | no | — |
| explain | boolean | no | — |
| context | integer | no | — |
Fetch the full record for any id (memory, decision, entity, session, task, agent). depth>0 adds graph edges.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| id | string | yes | — |
| depth | integer | no | — |
| max_tokens | integer | no | — |
Chronological activity (oldest→newest) for a project/entity/agent within a time range.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| project | string | no | — |
| entity | string | no | — |
| agent_filter | string | no | — |
| since | string | no | — |
| until | string | no | — |
| kinds | array | no | — |
| limit | integer | no | — |
| max_tokens | integer | no | — |
| format | string | no | — |
List open contradicting facts; or resolve one by passing resolve_id + keep_id (the other is superseded).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| resolve_id | string | no | — |
| keep_id | string | no | — |
| agent | string | no | — |
| api_key | string | no | — |
Find entities by name substring/type/project and expand along relations (rel_type e.g. calls, imports, defines, mentions, related_to, contradicts).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| name | string | no | — |
| type | string | no | — |
| project | string | no | — |
| rel_type | string | no | — |
| depth | integer | no | — |
| limit | integer | no | — |
Edges around any id (direction: in|out|both).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| id | string | yes | — |
| depth | integer | no | — |
| rel_types | array | no | — |
| direction | string | no | — |
| limit | integer | no | — |
| format | string | no | — |
Export graph as mermaid|graphml|json|html. If path is given, write to that file and return the path.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| format | string | no | — |
| project | string | no | — |
| include_items | boolean | no | — |
| path | string | no | — |
Index a local repo (Python + JS/TS): files, symbols, imports, calls → graph. Re-indexing is idempotent.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| path | string | yes | — |
| project | string | no | — |
| agent | string | no | — |
| api_key | string | no | — |
Find functions/classes/methods by (partial) name, with file:line, signature and docstring.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| name | string | no | — |
| project | string | no | — |
| types | array | no | — |
| path | string | no | — |
| limit | integer | no | — |
What depends on a symbol/file (reverse calls/imports, transitive) plus memories linked to it.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| symbol | string | yes | — |
| project | string | no | — |
| depth | integer | no | — |
| limit | integer | no | — |
| format | string | no | — |
Ask the language's own server (LSP) about code: kind definition | references | hover. Give a symbol (found through the code index of project) or path + line (+ col). Runs where the repo is: local owner/admins only.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| symbol | string | no | — |
| project | string | no | — |
| path | string | no | — |
| line | integer | no | — |
| col | integer | no | — |
| kind | string | no | — |
Open a work session. Returns session_id to use with checkpoint/handoff.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| goal | string | yes | — |
| project | string | no | — |
| state | object | no | — |
| agent | string | no | — |
| api_key | string | no | — |
Save progress in a session (note + merged structured state).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| session_id | string | yes | — |
| note | string | yes | — |
| state | object | no | — |
| related_ids | array | no | — |
| agent | string | no | — |
| api_key | string | no | — |
Write a structured handoff packet (summary, state, decisions, next steps, open questions, relevant ids) so another AI can resume(). Code work: pass repo (owner/name), branch and commit; Commons checks the commit on GitHub. session_id is optional: without it your latest active session (in…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| summary | string | no | — |
| session_id | string | no | — |
| state | string | no | — |
| decisions | array | no | — |
| next_steps | array | no | — |
| open_questions | array | no | — |
| relevant_ids | array | no | — |
| to_agent | string | no | — |
| goal | string | no | — |
| project | string | no | — |
| repo | string | no | — |
| branch | string | no | — |
| commit | string | no | — |
| agent | string | no | — |
| api_key | string | no | — |
Pick up a session (or the latest one in a project): handoff packet, state, session items, recent context.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| session_id | string | no | — |
| project | string | no | — |
| max_tokens | integer | no | — |
| agent | string | no | — |
| api_key | string | no | — |
Log a decision (what, alias decision) with its rationale (why, alias rationale) so other AIs can later ask why(). Link code/memory ids via related_ids.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| what | string | no | — |
| why | string | no | — |
| alternatives | array | no | — |
| evidence | array | no | — |
| project | string | no | — |
| session_id | string | no | — |
| related_ids | array | no | — |
| entities | array | no | — |
| tags | array | no | — |
| decision | string | no | — |
| rationale | string | no | — |
| agent | string | no | — |
| api_key | string | no | — |
Explain the logic behind something: query is free text or any id (symbol, memory, session).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| query | string | yes | — |
| project | string | no | — |
| max_tokens | integer | no | — |
Register (or re-key) an agent identity. Returns an api_key shown once; use it on writes.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| name | string | yes | — |
| vendor | string | no | — |
| model | string | no | — |
| description | string | no | — |
| capabilities | array | no | — |
| a2a_url | string | no | — |
Known agents with vendor/model/capabilities and last activity.
No parameter schema on file.
Ask another agent a question via the shared inbox (use '*' for any agent). Poll get_task for the answer.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| to_agent | string | yes | — |
| question | string | yes | — |
| context_ids | array | no | — |
| project | string | no | — |
| agent | string | no | — |
| api_key | string | no | — |
Delegate a task to another agent's inbox (or '*' for any agent).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| to_agent | string | yes | — |
| task | string | yes | — |
| context_ids | array | no | — |
| project | string | no | — |
| agent | string | no | — |
| api_key | string | no | — |
Tasks/questions addressed to you (or '*'). claim=True marks them claimed by you.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| status | string | no | — |
| claim | boolean | no | — |
| limit | integer | no | — |
| agent | string | no | — |
| api_key | string | no | — |
Answer/complete an inbox task (status: done|failed|claimed).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| task_id | string | yes | — |
| result | string | yes | — |
| status | string | no | — |
| agent | string | no | — |
| api_key | string | no | — |
Check status/result of a task you posted or were assigned.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| task_id | string | yes | — |
| agent | string | no | — |
| api_key | string | no | — |
Send a message to an external A2A agent endpoint (JSON-RPC message/send). Secrets are redacted first.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| url | string | yes | — |
| message | string | yes | — |
Register a secret *reference* (env://NAME, vault://mount/path#key, op://vault/item/field). Never a value.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ref | string | yes | — |
| description | string | no | — |
| project | string | no | — |
| allowed_agents | array | no | — |
| max_ttl | integer | no | — |
| agent | string | no | — |
| api_key | string | no | — |
List registered secret references (no values).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| project | string | no | — |
Get a short-lived lease handle for a secret ref. The value is NOT returned; it is injected at execution time (commons secret-exec <lease> --as VAR -- cmd). Audited.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ref | string | yes | — |
| scope | string | no | — |
| purpose | string | no | — |
| ttl | integer | no | — |
| agent | string | no | — |
| api_key | string | no | — |
Revoke a lease (or all of your leases / all leases for a ref).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| lease_id | string | no | — |
| ref | string | no | — |
| agent | string | no | — |
| api_key | string | no | — |
Audit trail of secret registration/lease/resolve/revoke events.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ref | string | no | — |
| limit | integer | no | — |
Counts of items/entities/relations/etc. and the active embedder.
No parameter schema on file.
Free
$0 forever
- Every tool, no call limit
- No card, and mcprush charges nothing for it
- Source published under MIT
- Runs on your machine — nothing of it reaches our gateway
- Nothing to cap, because mcprush bills nothing
What counts against your monthly calls
| Tool | Unit | Calls used | Out of the allowance |
|---|
Nothing here is billable: mcprush charges nothing to install Commons or to call it, at any volume.
Call allowance · this installenforced at the gateway
Monthly allowance, in calls
—
—
Alert at 80% · then the tool returns a normal MCP error
Used this month: —
—Grade not published
No rule-by-rule report on file for this release
Two independent axes, because powerful and malicious are different questions. The grade is threat only. The capability level is blast radius, and it is never a penalty on the grade — it is priced as one subtract-only term in the score, where you can see it.
This listing ships as a container image. The scanner reads packages on npm and PyPI and public source; an image is neither, so there is no grade here — not a withheld one, an unmeasured one.
Release history
It installs from a container image rather than from a versioned package, so the command cannot be pinned to a release. The history below is for reading; the current release on file is 0.33.0.
0.33.0
undated
latestNo release note was published with this version.
—
no reviews yet
Who can review
One review per account, from a signed-in account that does not publish this listing. Nothing else is asked — you can say what you think before you install it. Publishers can reply once per review, and a review can be edited or deleted by whoever wrote it.
Sign in to write one
Any signed-in account that does not publish Commons can review it, once — before installing it or after. A review from an account that has installed it is marked as one.
No reviews yet
Nobody has reviewed this listing. The rating on the card is the mean of the reviews written here and nothing else, so there is no rating until somebody writes the first — which takes a signed-in account that does not publish it, and nothing else.