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»).

NPM package agentwikis-mcp
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 (Claude Desktop وCursor وVS Code)
{
    "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_URL Base 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.

المحتويات
  1. agentwikis-mcp
  2. Install
  3. Pro (XL) access
  4. Self-hosted instances
  5. What's inside
  6. License

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:

ToolWhat it does
list_wikisEvery wiki + its declared scope (covers / not covered / current-as-of)
open_wikiOne wiki's metadata + full document map — orient in a single call
searchRanked pages with a calibrated confident flag — when false, fall back to web search
read_documentFull 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 keyWith a Pro key
open_wikifree pages; an xl field says how many Pro pages existfree + XL pages, XL marked gated: true
searchfree pages only; an xl field reports how many Pro pages were not searchedranks across both tiers, confident calibrated over the full corpus
read_document402 on an XL pathreturns 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 الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.