How do I install Dir?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Dir need an API key?

The publisher lists these environment variables: OASF_API_VALIDATION_SCHEMA_URL, DIRECTORY_CLIENT_SERVER_ADDRESS, DIRECTORY_CLIENT_AUTH_MODE, DIRECTORY_CLIENT_AUTH_TOKEN.

Dir

by io.github.agntcy

MCP server for working with OASF agent records in the Agntcy Directory.

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Local command

docker run -i --rm ghcr.io/agntcy/dir-mcp:1.3.4

Credentials from the publisher

OASF_API_VALIDATION_SCHEMA_URL — OASF schema server URL (e.g. https://schema.oasf.outshift.com)
DIRECTORY_CLIENT_SERVER_ADDRESS — Directory server address (default: 0.0.0.0:8888)
DIRECTORY_CLIENT_AUTH_MODE — Auth mode: none, github, x509, jwt, token
DIRECTORY_CLIENT_AUTH_TOKEN — Pre-issued bearer token for CI/scripts (skips interactive login)

Provider

Claude Code

OASF_API_VALIDATION_SCHEMA_URL=<value> DIRECTORY_CLIENT_SERVER_ADDRESS=<value> DIRECTORY_CLIENT_AUTH_MODE=<value> DIRECTORY_CLIENT_AUTH_TOKEN=<secret> claude mcp add io.github.agntcy-dir-mcp -- docker run -i --rm ghcr.io/agntcy/dir-mcp:1.3.4

Run in a terminal.

Claude Desktop

{
  "mcpServers": {
    "io.github.agntcy-dir-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/agntcy/dir-mcp:1.3.4"
      ],
      "env": {
        "OASF_API_VALIDATION_SCHEMA_URL": "<value>",
        "DIRECTORY_CLIENT_SERVER_ADDRESS": "<value>",
        "DIRECTORY_CLIENT_AUTH_MODE": "<value>",
        "DIRECTORY_CLIENT_AUTH_TOKEN": "<secret>"
      }
    }
  }
}

claude_desktop_config.json

Step-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Related MCP

Related skills

View all

Questions

How do I install Dir?: Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.
Does Dir need an API key?: The publisher lists these environment variables: OASF_API_VALIDATION_SCHEMA_URL, DIRECTORY_CLIENT_SERVER_ADDRESS, DIRECTORY_CLIENT_AUTH_MODE, DIRECTORY_CLIENT_AUTH_TOKEN.
What transport does Dir use?: Dir runs locally over stdio.
When was Dir last checked?: Last checked 2026-10-16. MCP server for working with OASF agent records in the Agntcy Directory.

MCP Server for Directory

Model Context Protocol (MCP) server for working with OASF agent records in the AGNTCY Agent Directory.

The server runs via the dirctl CLI and connects AI assistants and IDEs to Directory infrastructure. Use it to validate and publish agent metadata, search and discover records, navigate OASF skill and domain taxonomies, and generate records from a codebase.

Capabilities:

Work with OASF schemas and validate agent records
Search, push, and pull records from Directory servers
Verify record signatures and domain name ownership
Import from and export to MCP, A2A, Agent Skills, and GitHub Copilot formats
Start an embedded local Directory daemon automatically when the configured server is local (disable with DIR_MCP_DAEMON=false)
Run guided workflows via MCP prompts (create, validate, search, and more)

See docs/directory-mcp.md for full documentation — tools, prompts, setup, configuration, and usage.

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated. For detailed contributing guidelines, please see CONTRIBUTING.md.

License

Distributed under the Apache-2.0 License. See LICENSE.md for more information.

Dir