content-knowledge-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@content-knowledge-mcp Search guidelines for course launch post, list matching rule IDs and templates."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
content-knowledge-mcp
An MCP server that gives a content agent access to a company's editorial knowledge: brand rules, a visual template catalog, and past posts with their outcomes. The knowledge lives in plain markdown files the company owns; the server only exposes it.
Built as the technical core of my BA thesis on AI agents and workflow automation. The version here is the generic engine, with an invented company as example knowledge.
Why there is no vector database
The obvious move is to embed the knowledge and retrieve by similarity. This server deliberately does not, for two reasons.
At this scale, structured search over curated files wins. A company's editorial rules are tens of blocks, not tens of thousands. Splitting them into chunks and retrieving by cosine similarity adds an indexing step, a store to keep in sync and a class of failure that is hard to see, in exchange for recall you already had.
Every rule carries an ID, and that is the point. Rules are R1, R17, R905; templates are T901, T905; launch records are L2. The agent is instructed to cite the IDs it used. That turns each proposal into something a human can audit in seconds: the reviewer reads rules_used: ["R920", "R903"] and knows exactly which rules produced that post. An embedding returns a paragraph; it does not return an argument. When the goal is a human gate that works, being auditable beats being clever.
The cost is real and worth stating: search is lexical, so a query that shares no words with a rule will not find it. The server says NO_MATCH instead of pretending, which is the behaviour the evaluation cases check.
Related MCP server: OntoRamp Graph Query
Architecture
Claude Desktop / Claude Code ──stdio──┐
├──▶ content-knowledge-mcp ──▶ KNOWLEDGE_PATH/
n8n MCP Client Tool ──────────HTTP────┘ (3 tools) guidelines/*.md R# rules, L# launch records
(host.docker.internal:8765) templates/catalog.md T# catalog
past-posts/*.md past posts and outcomesThree tools, one transport switch, no state:
Tool | Returns |
| matching rule blocks with their |
| the template catalog, filtered, with |
| up to three past posts with their outcomes, for tone calibration |
The server owns no content. Point KNOWLEDGE_PATH at a different folder and it serves a different company: that is what made it publishable without touching the code.
Quickstart
git clone https://github.com/alessandro-martelli/content-knowledge-mcp
cd content-knowledge-mcp
python3 -m venv .venv && .venv/bin/pip install fastmcp
# run the twelve checks against the example knowledge
KNOWLEDGE_PATH=examples/knowledge .venv/bin/python smoke_test.py
# stdio, for Claude Desktop or Claude Code
KNOWLEDGE_PATH=examples/knowledge .venv/bin/python server.py
# HTTP on :8765, for the n8n MCP Client Tool
KNOWLEDGE_PATH=examples/knowledge .venv/bin/python server.py --httpThe example knowledge under examples/knowledge/ is entirely invented: a fictional design school, with rules, launch records, a template catalog and three past posts. It exists so the repo runs for anyone, and so the tests have something to bite on.
Evaluation
Smoke tests: 12/12. Each check goes through a real fastmcp.Client over the protocol, not through the helper functions, so a break in tool registration or transport shows up here.
Agent-level protocol: 8 cases, 5 of them adversarial (conflicting rules, out-of-scope request, tool unavailable, no matching template, underspecified input). Executed August 2026 against the two agents' prompts: 6 of 8 passed, every output was valid JSON on the first try, and the two failures were defects in the test suite rather than in the agent. Both are written up in eval/test-log.md with the fix each one needs. The log is kept as it came out: a suite that only ever reports success is not measuring anything.
Honest limits
Search is lexical and scores by term frequency. It does not understand synonyms; a rule phrased in words the query does not use will not be found.
The knowledge folder layout is fixed (
guidelines/,templates/catalog.md,past-posts/), and the catalog filename is hardcoded.There is no write path and no cache: every call reads the files. That is fine at this size and would not be at ten thousand blocks.
The two open defects from the evaluation are not fixed in this code yet:
rules_usedcannot citeL#records, and the plan schema cannot express a row whose channel is unknown.
Licence
MIT, see LICENSE.
Available Tools
3 toolsget_post_examplesA
Retrieve past posts with their outcomes, for tone calibration. Query by topic, channel or type, e.g. 'linkedin annuncio'. Returns up to 3 examples; never copy sentences from them.
Inputs: query. Returns: result
list_visual_templatesA
List the official visual template catalog with usage rules (T# IDs). Optional query filters by content type, e.g. 'annuncio corso'. Empty query returns the full catalog.
Inputs: query. Returns: result
search_guidelinesB
Search the company brand and editorial rules. Returns matching rule blocks with their IDs (R#), e.g. 'tone course post linkedin'.
Inputs: query (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool targets a distinct knowledge resource: editorial rules, visual templates, and past post examples. The descriptions clearly distinguish search, list, and get operations despite all supporting query. An agent can reliably choose the correct tool for each content creation step.
All tool names follow the consistent snake_case verb_noun pattern: search_guidelines, list_visual_templates, get_post_examples. The verbs also accurately reflect the operation type, making the naming predictable and scannable.
With only three tools, the server is tightly focused on content knowledge retrieval. Each tool covers a core knowledge domain for content creation—rules, templates, and examples—without redundant or unnecessary additions.
The set covers the main content-making inputs: brand/editorial guidelines, visual template catalog, and performance-calibrated post examples. Minor gaps exist such as fetching a specific rule by ID or retrieving more than three examples, but the tool set supports its purpose effectively.
Related MCP Connectors
Governed company memory: search decisions, rules and client facts; propose updates for review.
Brand strategy and content-calendar context for agents, with human-confirmed approval gates.
Read-only canon of design and copy rules for AI agents to audit generated UI, served as resources.
Read-only AgentiScript concept search, catalog, authenticity, license, and approved asset discovery.
Related MCP Servers
- AlicenseBqualityBmaintenanceEnables AI agents to access and manage project guidelines, documentation, and context through a structured content system with template support and workflow management.38168 PyPIMIT
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to query organizational architecture and governance constraints, returning evidence-grounded answers from documented structures.MIT
- AlicenseNot gradedqualityBmaintenanceProvides read-only knowledge search and guarded action proposal tools. Write-like actions require human approval and return traceable evidence with policy events.1MIT
- AlicenseAqualityCmaintenanceEnables agents to search and reference trusted, out-of-band ingested source state, run claim-bound document reviews, validate evidence-status proposals against admissibility guards, and build evidence matrices. It keeps proposal, evidence, admissibility, and adjudication separate so agents can propose epistemic statuses without creating the source facts, page locators, provenance, or missingness records that support them.5MIT