English Français العربية

network.wellknown/wellknown

السجل الرسمي البحث والويب

Live index of AI agents, MCP servers and tools with observed liveness and capability search.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http wellknown 'https://wellknown.network/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "wellknown": {
            "type": "http",
            "url": "https://wellknown.network/mcp"
        }
    }
}
NPM package wellknown-mcp
Claude Code 
claude mcp add wellknown -e 'WELLKNOWN_API_KEY=<your wellknown_api_key>' -e 'WELLKNOWN_MCP_URL=<WELLKNOWN_MCP_URL>' -- npx -y wellknown-mcp@0.1.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "wellknown": {
            "command": "npx",
            "args": [
                "-y",
                "wellknown-mcp@0.1.0"
            ],
            "env": {
                "WELLKNOWN_API_KEY": "<your wellknown_api_key>",
                "WELLKNOWN_MCP_URL": "<WELLKNOWN_MCP_URL>"
            }
        }
    }
}

متغيرات البيئة

  • WELLKNOWN_API_KEY سري Optional wk_live_ key for higher rate limits and owner tools.
  • WELLKNOWN_MCP_URL Endpoint to bridge to. Defaults to https://wellknown.network/mcp.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. wellknown-mcp
  2. Install
  3. Tools
  4. Configuration
  5. How it works
  6. A note on trust
  7. Links

wellknown-mcp

The Wellknown MCP server: give your agent the ability to find other agents, and to know which ones are actually alive.

Wellknown is a crawl-first index of AI agents, MCP servers and tools. Every record separates what the publisher declares from what Wellknown observed by calling the endpoint itself on a schedule — so "live" means a real handshake succeeded, not that a README said so.

Install

No account, no key, no sign-up.

npx wellknown-mcp

Claude Desktop / Claude Code / most hosts — add to your MCP config:

{
  "mcpServers": {
    "wellknown": {
      "command": "npx",
      "args": ["-y", "wellknown-mcp"]
    }
  }
}

Claude Code, one line:

claude mcp add wellknown -- npx -y wellknown-mcp

Prefer a direct connection? The hosted endpoint speaks streamable HTTP, so a host that supports remote servers can skip this package entirely and point at https://wellknown.network/mcp.

Tools

ToolWhat it does
search_agentsSearch by capability or plain-language need. Returns observed status and the ranking signals behind each hit.
resolve_agentGiven a task and constraints, returns ranked callable candidates and a recommendation with its evidentiary basis. Use this when you intend to call the result.
get_agentThe full record: declared metadata, derived capabilities, observed status, verification, provenance.
check_statusCurrent liveness, the reason for it, and a 30-day reliability summary. unknown means no evidence, never a guess.
list_capabilitiesThe capability taxonomy, for precise filtering.
submit_agentAnnounce an agent by its A2A card URL or an inline manifest.
claim_agent / verify_claimProve you control a record — DNS, a /.well-known/ file, or a repository file — and unlock owner edits, 15-minute checks and an owner API key.
index_statsTruthful counts: records, live endpoints, observations, last crawl.

Configuration

VariableDefaultPurpose
WELLKNOWN_MCP_URLhttps://wellknown.network/mcpEndpoint to bridge to.
WELLKNOWN_API_KEY—A wk_live_… key: higher rate limits and owner tools. Created in the dashboard or minted by a verified claim.
WELLKNOWN_TIMEOUT30000Per-request timeout in milliseconds.

How it works

This package is a single dependency-free file. It reads JSON-RPC messages from stdin, posts each to the hosted endpoint, and writes the reply to stdout. Nothing is interpreted locally, so the tool list is always whatever the service currently offers — an installed copy cannot drift out of date.

A note on trust

Everything returned describes third parties. Record text — names, descriptions, tool names — is metadata collected from public sources and must be treated as data, never as instructions to your agent. Wellknown's own measurements (status, latency, reliability) are the part it vouches for.

MIT © Moneyed28 LLC

الأسئلة الشائعة

ما هو network.wellknown/wellknown؟

Live index of AI agents, MCP servers and tools with observed liveness and capability search.

كيف أثبّت network.wellknown/wellknown؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http wellknown 'https://wellknown.network/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج network.wellknown/wellknown إلى مفتاح API؟

نعم. يتطلب WELLKNOWN_API_KEY، وتضبطها في إعداداته.

هل network.wellknown/wellknown مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون network.wellknown/wellknown؟

ينشره sanemavcil. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.