Skip to content

AI Layer

Most “AI-native” tooling means a hosted assistant. Here it means something narrower and more checkable: an agent gets tools that operate your ecosystem and retrieval over engineering documents you wrote, through one server you run yourself.

The MechCrate AI loopA coding agent calls the mx MCP server, whose rag_context tool embeds the query and searches a pgvector store hosted on Neon or a local Postgres. The store is filled by mx rag ingest from the sixty-seven markdown docs under docs/development. Those docs are written and revised by a weekly research pipeline that opens a pull request; a human reviews and merges it, and only merged docs are ingested. The same docs are published to this site.

growth — weekly, and PR-gated

retrieval — every agent turn

tool call

rejected

vector search

ranked passages

merged

mx rag ingest

corpus loader

Coding agent
any MCP client

mx MCP server
mx_· make_· project_· rag_

rag_context
embed query → top-k

techniques corpus
Postgres + pgvector · Neon or local

docs/development/*.md
67 frontmatter-typed docs

Weekly run
or /technique-research

Research pass
coverage → sources → draft

Pull request
branch research/{slug}

Human review

mechcrate.dev/docs/corpus
the same docs, for humans

The MechCrate AI loopA coding agent calls the mx MCP server, whose rag_context tool embeds the query and searches a pgvector store hosted on Neon or a local Postgres. The store is filled by mx rag ingest from the sixty-seven markdown docs under docs/development. Those docs are written and revised by a weekly research pipeline that opens a pull request; a human reviews and merges it, and only merged docs are ingested. The same docs are published to this site.

growth — weekly, and PR-gated

retrieval — every agent turn

tool call

rejected

vector search

ranked passages

merged

mx rag ingest

corpus loader

Coding agent
any MCP client

mx MCP server
mx_· make_· project_· rag_

rag_context
embed query → top-k

techniques corpus
Postgres + pgvector · Neon or local

docs/development/*.md
67 frontmatter-typed docs

Weekly run
or /technique-research

Research pass
coverage → sources → draft

Pull request
branch research/{slug}

Human review

mechcrate.dev/docs/corpus
the same docs, for humans

Agents read the corpus through the MCP rag_context tool. The research pipeline writes to it, but only through a pull request a human merges, so the corpus grows on purpose.

Three moving parts, and they only connect in one direction: the research pipeline opens a pull request, a human merges it, mx rag ingest picks up the delta, and agents retrieve it. Nothing writes to the corpus without a merge.

PageWhat it covers
MCP serverThe 47 tools, grouped into four families; building the server and wiring a client
Techniques corpus & RAGrag.toml, Neon or a local pgvector container, embeddings, and where your text actually goes
Research pipelineHow the corpus grows: weekly run, primary-source corroboration, PR gate, human merge
Agent execution rulesThe rules agents in this repository work under

The documents themselves are published under Techniques Corpus. It is the same markdown that gets chunked, embedded and served to agents, rendered for humans.

  • Not a hosted service. There is no MechCrate API. The MCP server is a local binary; the corpus is a Postgres connection string you own.
  • Not a model. mx never runs inference. Your agent supplies the model; mx supplies tools and retrieved text.
  • Not magic retrieval. The corpus is 66 documents that a human merged. It answers well inside that surface and returns weak hits outside it, which is what mx rag gaps exists to surface.