io.github.agntcy/dir-mcp MCP Server

This Model Context Protocol (MCP) server provides functionality for working with OASF agent records in the Agntcy Directory. It is described as an “MCP Server for Directory,” with repository context indicating CI, release status, coverage, and license information.

🛠️ Key Features

Works with OASF agent records
Integrates via Model Context Protocol (MCP)
Targets the Agntcy Directory

🚀 Use Cases

Accessing or managing entries for OASF agent records in the Agntcy Directory

⚡ Developer Benefits

MCP-based directory tooling for OASF agent record workflows
Public repository indicators for release, CI, and test coverage

📄 Related Repository Metadata

GitHub release status badge
CI workflow badge (main branch)
Code coverage badge (main branch)
License information available

⚠️ Limitations

Provided data includes no details about specific MCP tools, inputs/outputs, or supported operations beyond directory and OASF agent record scope.

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.4"
      ],
      "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