English Français العربية

io.github.agntcy/dir-mcp

Official registry AI and agents

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

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

OCI package ghcr.io/agntcy/dir-mcp:1.3.4
Claude Code 
claude mcp add dir-mcp -e 'OASF_API_VALIDATION_SCHEMA_URL=<OASF_API_VALIDATION_SCHEMA_URL>' -e 'DIRECTORY_CLIENT_SERVER_ADDRESS=<DIRECTORY_CLIENT_SERVER_ADDRESS>' -e 'DIRECTORY_CLIENT_AUTH_MODE=<DIRECTORY_CLIENT_AUTH_MODE>' -e 'DIRECTORY_CLIENT_AUTH_TOKEN=<your directory_client_auth_token>' -- docker run -i --rm ghcr.io/agntcy/dir-mcp:1.3.4
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "dir-mcp": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/agntcy/dir-mcp:1.3.4"
            ],
            "env": {
                "OASF_API_VALIDATION_SCHEMA_URL": "<OASF_API_VALIDATION_SCHEMA_URL>",
                "DIRECTORY_CLIENT_SERVER_ADDRESS": "<DIRECTORY_CLIENT_SERVER_ADDRESS>",
                "DIRECTORY_CLIENT_AUTH_MODE": "<DIRECTORY_CLIENT_AUTH_MODE>",
                "DIRECTORY_CLIENT_AUTH_TOKEN": "<your directory_client_auth_token>"
            }
        }
    }
}

Environment variables

  • OASF_API_VALIDATION_SCHEMA_URL required 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 secret Pre-issued bearer token for CI/scripts (skips interactive login)
MCPB package https://github.com/agntcy/dir-mcp/releases/download/v1.3.4/dir-mcp.mcpb

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

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.

Frequently asked questions

What is io.github.agntcy/dir-mcp?

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

How do I install io.github.agntcy/dir-mcp?

It runs on your machine. In Claude Code: claude mcp add dir-mcp -e 'OASF_API_VALIDATION_SCHEMA_URL=<OASF_API_VALIDATION_SCHEMA_URL>' -e 'DIRECTORY_CLIENT_SERVER_ADDRESS=<DIRECTORY_CLIENT_SERVER_ADDRESS>' -e 'DIRECTORY_CLIENT_AUTH_MODE=<DIRECTORY_CLIENT_AUTH_MODE>' -e 'DIRECTORY_CLIENT_AUTH_TOKEN=<your directory_client_auth_token>' -- docker run -i --rm ghcr.io/agntcy/dir-mcp:1.3.4. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.agntcy/dir-mcp need an API key?

Yes. It expects OASF_API_VALIDATION_SCHEMA_URL, DIRECTORY_CLIENT_AUTH_TOKEN, which you set in its configuration.

Is io.github.agntcy/dir-mcp open source?

Yes. Its code is on GitHub under the Apache-2.0 license.

Who maintains io.github.agntcy/dir-mcp?

It is published by agntcy. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.