SERVER

dir-mcp

Rank #8,532

io.github.agntcy/dir-mcp

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

2 versions

2 GitHub stars

by agntcy (2 servers)View repository ↗Claim this server

First listed

Apr 21, 2026

Last publish date

Jul 29, 2026

OVERVIEW

dir-mcp is a Model Context Protocol (MCP) server published by agntcy. It ranks #8,532 of 132,113 servers tracked on MCP Toplist, and its repository has 2 GitHub stars. dir-mcp is listed across 3 registries — Official MCP, PulseMCP and Glama, with 2 tracked versions. It was first listed on Apr 21, 2026 and most recently updated on Jul 29, 2026.

STANDING

#8,532of 132,113 tracked serversTop 10%

Ranks ahead of 123,581 of 132,113 servers on MCP Toplist.

CONNECT

Use dir-mcp

No setupRuns out of the box

No credentials or required configuration declared — add it to your MCP client and go.

Docker image

claude mcp add dir-mcp -e "OASF_API_VALIDATION_SCHEMA_URL=<your OASF_API_VALIDATION_SCHEMA_URL>" -e "DIRECTORY_CLIENT_SERVER_ADDRESS=<your DIRECTORY_CLIENT_SERVER_ADDRESS>" -e "DIRECTORY_CLIENT_AUTH_MODE=<your 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

Replace each placeholder with your own value before saving.

MCP bundle

Published as mcp bundle `https://github.com/agntcy/dir-mcp/releases/download/v1.3.4/dir-mcp.mcpb` — install it through your client’s extension manager.

Docker image

[mcp_servers.dir-mcp]
command = "docker"
args = ["run", "-i", "--rm", "ghcr.io/agntcy/dir-mcp:1.3.4"]

[mcp_servers.dir-mcp.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>"

Add to ~/.codex/config.toml. Replace each placeholder with your own value before saving.

MCP bundle

Published as mcp bundle `https://github.com/agntcy/dir-mcp/releases/download/v1.3.4/dir-mcp.mcpb` — install it through your client’s extension manager.

Docker image

{
  "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>"
      }
    }
  }
}

Add to claude_desktop_config.json (Settings → Developer → Edit Config). Replace each placeholder with your own value before saving.

MCP bundle

Published as mcp bundle `https://github.com/agntcy/dir-mcp/releases/download/v1.3.4/dir-mcp.mcpb` — install it through your client’s extension manager.

Docker image

{
  "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>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project). Replace each placeholder with your own value before saving.

MCP bundle

Published as mcp bundle `https://github.com/agntcy/dir-mcp/releases/download/v1.3.4/dir-mcp.mcpb` — install it through your client’s extension manager.

Docker image

{
  "servers": {
    "dir-mcp": {
      "type": "stdio",
      "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>"
      }
    }
  }
}

Save as .vscode/mcp.json in your workspace. Replace each placeholder with your own value before saving.

MCP bundle

Published as mcp bundle `https://github.com/agntcy/dir-mcp/releases/download/v1.3.4/dir-mcp.mcpb` — install it through your client’s extension manager.

Docker image

{
  "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>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json. Replace each placeholder with your own value before saving.

MCP bundle

Published as mcp bundle `https://github.com/agntcy/dir-mcp/releases/download/v1.3.4/dir-mcp.mcpb` — install it through your client’s extension manager.

Docker image

{
  "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>"
      }
    }
  }
}

Replace each placeholder with your own value before saving.

MCP bundle

Published as mcp bundle `https://github.com/agntcy/dir-mcp/releases/download/v1.3.4/dir-mcp.mcpb` — install it through your client’s extension manager.

BADGE

Show your rank

Maintain this server? Add the live rank badge to your README — it updates automatically as the leaderboard changes.

Markdown

[![MCP Toplist](https://mcptoplist.com/badge/io.github.agntcy%2Fdir-mcp.svg)](https://mcptoplist.com/server/io.github.agntcy%2Fdir-mcp)

HTML

<a href="https://mcptoplist.com/server/io.github.agntcy%2Fdir-mcp"><img src="https://mcptoplist.com/badge/io.github.agntcy%2Fdir-mcp.svg" alt="MCP Toplist: Top 10% of 132,113" /></a>

Variants: append ?metric=score or ?metric=stars to the image URL.

REGISTRIES

Listed on 3 registries

ORGANIZATION

agntcy

Organization

Servers in org

2

Versions across org

7

MORE FROM THIS PUBLISHER

Other servers by agntcy

Identity#5,881 · 5 vers

View all agntcy servers →

VERSIONS

Available versions (2)

Version	Published
1.3.4	Jul 29, 2026
1.3.3-mcp.3	Jul 23, 2026

FAQ

Frequently asked questions

Who maintains dir-mcp?: dir-mcp is maintained by agntcy, which publishes 2 MCP servers (7 total versions) tracked on MCP Toplist.
Is dir-mcp listed on the Official MCP Registry?: Yes — dir-mcp is listed on the Official MCP Registry, alongside PulseMCP and Glama.
How many versions does dir-mcp have?: MCP Toplist tracks 2 versions of dir-mcp, most recently published on Jul 29, 2026.
Where can I find the source code for dir-mcp?: The source code for dir-mcp is hosted at github.com/agntcy/dir-mcp.

Used in projects

Do you run this server?

Add to a project

Community projects list the MCP servers behind real agents and apps. Publish yours and this page will link to it.

EXPLORE

All MCP Servers Official MCP Servers GitHub MCP Servers Best MCP Servers Most Active MCP Servers New MCP Servers Best New MCP Servers

dir-mcp by agntcy | MCP Toplist