Agent Wikis
Maintained, agent-readable knowledge bases with calibrated search and provenance. Pro key adds XL.
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
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>"
}
}
}
}
متغيرات البيئة
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_KEYسري 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.
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على 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
الأسئلة الشائعة
ما هو Agent Wikis؟
Maintained, agent-readable knowledge bases with calibrated search and provenance. Pro key adds XL.
كيف أثبّت Agent Wikis؟
يعمل على جهازك. في 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. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج Agent Wikis إلى مفتاح API؟
نعم. يتطلب AGENTWIKIS_API_KEY، وتضبطها في إعداداته.
هل Agent Wikis مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص MIT.
من يصون Agent Wikis؟
ينشره tonbistudio. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.