The Model Context Protocol (MCP) server io.github.agntcy/dir-mcp provides an interface for working with OASF agent records in the Agntcy Directory. Its purpose is to support MCP-based access to directory data related to agent records, using the server identified by the slug io-github-agntcy-dir-mcp.

🛠️ Key Features

MCP server for “working with OASF agent records”
Integrated with the “Agntcy Directory”
Server identified as io.github.agntcy/dir-mcp (slug: io-github-agntcy-dir-mcp)

🚀 Use Cases

Retrieve or manage OASF agent records from the Agntcy Directory via MCP

⚡ Developer Benefits

Standardized MCP integration for accessing Agntcy Directory agent records

⚠️ Limitations

No additional details provided (e.g., specific tools, capabilities, configuration, or constraints) beyond OASF agent record access.

MCP Server for 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

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.

Install

Configuration

Environment variables

OASF_API_VALIDATION_SCHEMA_URLrequired

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_TOKENsecret

Pre-issued bearer token for CI/scripts (skips interactive login)

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "dir-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/agntcy/dir-mcp:1.3.3-mcp.3"
      ],
      "env": {
        "OASF_API_VALIDATION_SCHEMA_URL": "<YOUR_OASF_API_VALIDATION_SCHEMA_URL>",
        "DIRECTORY_CLIENT_SERVER_ADDRESS": "<YOUR_DIRECTORY_CLIENT_SERVER_ADDRESS>",
        "DIRECTORY_CLIENT_AUTH_MODE": "<YOUR_DIRECTORY_CLIENT_AUTH_MODE>",
        "DIRECTORY_CLIENT_AUTH_TOKEN": "<YOUR_DIRECTORY_CLIENT_AUTH_TOKEN>"
      }
    }
  }
}

io.github.agntcy/dir-mcp