@agntcy/dir-mcp

npm package for the AGNTCY Agent Directory MCP server.

Downloads the platform-specific binary from GitHub Releases on install and exposes it as a runnable command — no Go toolchain required.

Install

npm install -g @agntcy/dir-mcp

Usage

As an MCP server (Claude / Cursor / VS Code)

Add to your MCP config:

{
  "mcpServers": {
    "agntcy-dir": {
      "command": "dir-mcp",
      "env": {
        "OASF_API_VALIDATION_SCHEMA_URL": "https://schema.oasf.outshift.com",
        "DIRECTORY_CLIENT_SERVER_ADDRESS": "0.0.0.0:8888",
        "DIRECTORY_CLIENT_AUTH_MODE": "none"
      }
    }
  }
}

Or use npx without a global install:

{
  "mcpServers": {
    "agntcy-dir": {
      "command": "npx",
      "args": ["-y", "@agntcy/dir-mcp"],
      "env": {
        "OASF_API_VALIDATION_SCHEMA_URL": "https://schema.oasf.outshift.com",
        "DIRECTORY_CLIENT_SERVER_ADDRESS": "0.0.0.0:8888",
        "DIRECTORY_CLIENT_AUTH_MODE": "none"
      }
    }
  }
}

Environment variables

| Variable | Required | Description | |----------|----------|-------------| | OASF_API_VALIDATION_SCHEMA_URL | Yes | OASF schema server URL | | DIRECTORY_CLIENT_SERVER_ADDRESS | No | Directory server address (default 0.0.0.0:8888) | | DIRECTORY_CLIENT_AUTH_MODE | No | Auth mode: none, github, x509, jwt, token | | DIRECTORY_CLIENT_AUTH_TOKEN | No | Pre-issued bearer token for CI/scripts |

Config file

Instead of setting shell environment variables, create ~/.config/dir-mcp/config.json:

{
  "DIRECTORY_CLIENT_SERVER_ADDRESS": "0.0.0.0:8888",
  "DIRECTORY_CLIENT_AUTH_MODE": "none",
  "DIRECTORY_CLIENT_AUTH_TOKEN": "your-token"
}

The wrapper reads this file on every startup. Process environment variables and mcp.json env entries take precedence over config file values, so they can still override individual keys.

To use a different path, set DIR_MCP_CONFIG=/path/to/config.json.

Dependencies installation

npm install runs a postinstall step that downloads the two binaries this platform needs (mcp-server, dirctl) from GitHub Releases. If you already have the binaries, you can set these values in the config:

• Set DIR_MCP_SKIP_INSTALL=1 to skip the download during npm install.
• Point DIRECTORY_MCP_PATH (and optionally DIRECTORY_DIRCTL_PATH) at binaries you've placed yourself, via env var or the config file above.

Supported platforms

| OS | Architecture | |----|-------------| | macOS | arm64, x64 | | Linux | arm64, x64 | | Windows | x64 |

License

Apache-2.0