Agent Wikis
Maintained, agent-readable knowledge bases with calibrated search and provenance. Pro key adds XL.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
agentwikis-mcpclaude mcp add agent-wikis -e 'AGENTWIKIS_URL=https://agentwikis.com' -e 'AGENTWIKIS_API_KEY=<your agentwikis_api_key>' -- npx -y agentwikis-mcp@0.2.3
{
"mcpServers": {
"agent-wikis": {
"command": "npx",
"args": [
"-y",
"agentwikis-mcp@0.2.3"
],
"env": {
"AGENTWIKIS_URL": "https://agentwikis.com",
"AGENTWIKIS_API_KEY": "<your agentwikis_api_key>"
}
}
}
}
Environment variables
AGENTWIKIS_URLBase URL of the Agent Wikis instance to query. Defaults to https://agentwikis.com; set to point at a self-hosted/private instance.AGENTWIKIS_API_KEYsecret Agent Wikis Pro API key. When set, open_wiki, search, and read_document include the Pro (XL) tier; without it the server serves the free tier only.
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
agentwikis-mcp
MCP server for Agent Wikis — maintained, agent-readable knowledge bases compiled from messy, fast-moving sources. Read-only; no API key or account needed for the free tier, and an optional Pro key adds the XL tier.
Four tools shaped for an agent's loop:
| Tool | What it does |
|---|---|
list_wikis | Every wiki + its declared scope (covers / not covered / current-as-of) |
open_wiki | One wiki's metadata + full document map — orient in a single call |
search | Ranked pages with a calibrated confident flag — when false, fall back to web search |
read_document | Full page or a single section, with a provenance footer |
The scope declarations and the confident flag exist so your agent knows when not to trust the wiki — measured ~94% correct abstention. Details and the full eval: agentwikis.com/why-wikis.
Install
Claude Code
claude mcp add agentwikis -- npx -y agentwikis-mcp
Codex (~/.codex/config.toml)
[mcp_servers.agentwikis]
command = "npx"
args = ["-y", "agentwikis-mcp"]
Any MCP client (JSON config)
{ "mcpServers": { "agentwikis": { "command": "npx", "args": ["-y", "agentwikis-mcp"] } } }
Pro (XL) access
Wikis ship in two tiers: the free wiki/ pages, and an XL tier of deeper
per-item reference pages included with Agent Wikis Pro.
Set AGENTWIKIS_API_KEY to your Pro key and all three read tools widen to cover it:
{
"mcpServers": {
"agentwikis": {
"command": "npx",
"args": ["-y", "agentwikis-mcp"],
"env": { "AGENTWIKIS_API_KEY": "aw_..." }
}
}
}
Hermes Agent: keep the key in your profile's .env and map it in
config.yaml. Hermes passes a stdio server only its configured env, never
the .env itself. If the variable is unset, the server falls back to the free
tier.
mcp_servers:
agentwikis:
command: npx
args: ["-y", "agentwikis-mcp"]
env:
AGENTWIKIS_API_KEY: "${AGENTWIKIS_API_KEY}"
| Without a key | With a Pro key | |
|---|---|---|
open_wiki | free pages; an xl field says how many Pro pages exist | free + XL pages, XL marked gated: true |
search | free pages only; an xl field reports how many Pro pages were not searched | ranks across both tiers, confident calibrated over the full corpus |
read_document | 402 on an XL path | returns the XL page |
Without a key, a confident: true search result means "the best free page covers
your terms" — the xl field on the response tells you how much you didn't see.
Routing tip. XL pages are per-item depth, not broader coverage. When a question
names a specific plugin, hook, CLI surface, runtime, API, or deployment procedure,
prefer the gated: true page over the general concept page.
Self-hosted instances
Point the bridge at your own Agent Wikis deployment (e.g. a private-wiki install):
AGENTWIKIS_URL=https://wikis.internal.example npx -y agentwikis-mcp
What's inside
The bridge talks to agentwikis.com/api/* and returns the same payloads as the self-hosted stdio server — same document formatting, same provenance footers, same search calibration. Requires Node 18+.
Agent Wikis also serves everything as plain Markdown + llms.txt if you'd rather skip MCP entirely: see agentwikis.com/for-agents.
License
MIT
Frequently asked questions
What is Agent Wikis?
Maintained, agent-readable knowledge bases with calibrated search and provenance. Pro key adds XL.
How do I install Agent Wikis?
It runs on your machine. In Claude Code: claude mcp add agent-wikis -e 'AGENTWIKIS_URL=https://agentwikis.com' -e 'AGENTWIKIS_API_KEY=<your agentwikis_api_key>' -- npx -y agentwikis-mcp@0.2.3. For other clients, paste the JSON configuration from this page into their MCP settings.
Does Agent Wikis need an API key?
Yes. It expects AGENTWIKIS_API_KEY, which you set in its configuration.
Is Agent Wikis open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains Agent Wikis?
It is published by tonbistudio. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.