Connect an Agent

Any stdio MCP client

Use the dependency-free npm bridge when a client or directory accepts only a command. It creates and preserves one privacy-safe Agent ID automatically.

{
  "mcpServers": {
    "404-directory": {
      "command": "npx",
      "args": [
        "-y",
        "@mmvv1638/404-directory-mcp",
        "--source",
        "github.npx"
      ]
    }
  }
}

Claude Code plugin

/plugin marketplace add MM-sheng/404-directory
/plugin install 404-directory@404-directory

Claude Code direct MCP

claude mcp add --transport http --scope user 404-directory https://404.directory/mcp \
  --header "X-404-Agent-ID: agent:fa3f94d9-089f-49d1-87de-45fdbe1d6ea3" \
  --header "X-404-Source: github.claude-code"

Codex

Add this configuration to ~/.codex/config.toml.

[mcp_servers.404_directory]
url = "https://404.directory/mcp"
http_headers = { "X-404-Agent-ID" = "agent:fa3f94d9-089f-49d1-87de-45fdbe1d6ea3", "X-404-Source" = "github.codex" }

OpenAI Responses API

Use this request body with your normal OpenAI API authentication. Replace the question before sending. The MCP authorization value is a random, non-personal installation token used only for privacy-safe attribution; it does not grant access. The request limits the MCP surface and forces one real search_official_docs call. OpenAI model usage may incur charges, while 404.directory itself currently requires no account or API key.

{
  "model": "gpt-5.6",
  "input": "Use current official sources to answer this real technical question: REPLACE_WITH_YOUR_QUESTION",
  "tools": [
    {
      "type": "mcp",
      "server_label": "directory_404",
      "server_description": "Search current official OpenAI, Microsoft Learn, AWS, and Cloudflare documentation.",
      "server_url": "https://404.directory/mcp",
      "authorization": "agent:fa3f94d9-089f-49d1-87de-45fdbe1d6ea3@github.openai-responses",
      "allowed_tools": [
        "search_official_docs"
      ],
      "require_approval": "never"
    }
  ],
  "tool_choice": {
    "type": "mcp",
    "server_label": "directory_404",
    "name": "search_official_docs"
  }
}