Dir Mcp
io.github.agntcyPublished by GitHub account agntcyv1.3.4Updated Oct 24, 2026
MCP server for working with OASF agent records in the Agntcy Directory.
Overview
Lets an assistant validate, publish, search, and convert OASF agent records in the AGNTCY Agent Directory via the dirctl CLI.
- What you can do
- Connects an assistant to AGNTCY Directory infrastructure through the dirctl CLI. It validates agent records against OASF schemas, searches, pushes, and pulls records from Directory servers, verifies record signatures and domain name ownership, and imports or exports records in MCP, A2A, Agent Skills, and GitHub Copilot formats. It also offers guided MCP prompts for creating, validating, and searching records.
- When to use it
- Useful when building or maintaining agent metadata for the AGNTCY Agent Directory, or when an assistant should discover, validate, or publish OASF agent records and convert them between agent formats.
- Requirements
- Runs locally as a stdio process (OCI image or mcpb bundle) and depends on the dirctl CLI. Needs a Directory server address (DIRECTORY_CLIENT_SERVER_ADDRESS, default 0.0.0.0:8888) and the required OASF schema server URL (OASF_API_VALIDATION_SCHEMA_URL). Authentication mode is set by DIRECTORY_CLIENT_AUTH_MODE; a pre-issued bearer token can be supplied via DIRECTORY_CLIENT_AUTH_TOKEN. Desktop only.
Installation
In SourceWeft
- Open Dir Mcp in the dashboard and add it to a workspace.
- Enable the server for the chats that should use its tools.
Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.
Other MCP clients
Follow the launch instructions in the repository.
README
MCP Server for Directory
[GitHub Release (latest by date)] [CI] [Coverage] [License] [OpenSSF Scorecard]
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.
Source: README.md at commit 1ae34bb
Tools
0Version history
1- v1.3.4LatestSep 16, 2026
Score
50% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
- Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
- Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
- Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
- DescriptionRequired15 pts
- Logo10 pts
- Documentation15 pts
- License10 pts