@absolutejs/agents-mcp

@absolutejs/agents-mcp

A production, read-only MCP server for finding cryptographically verified AI agents and production agent-first packages in the AbsoluteJS public registry. It gives MCP clients one installable discovery surface for agent names, capabilities, protocols, publishers, authentication metadata, and signed descriptors.

Run it

{
  "mcpServers": {
    "absolute-agents": {
      "command": "npx",
      "args": ["-y", "@absolutejs/agents-mcp"]
    }
  }
}

No credentials are required. The server fetches the public HTTPS registry, refuses redirects, bounds response size and time, validates every record, and caches successful indexes briefly. To use a compatible federated registry, set ABSOLUTE_AGENT_REGISTRY_URL to its HTTPS index URL. The package catalog is independently configurable with ABSOLUTE_PACKAGE_REGISTRY_URL.

MCP surface

• search_agents filters verified listings by text, capability, and MCP/A2A/ Arazzo/WebMCP/HTTP/OpenAPI/WebSocket interface type, with bounded pagination.
• get_agent returns one listing by canonical discovery ID or agent URL.
• search_packages filters the production AbsoluteJS catalog by purpose, category, and supported standard.
• get_package returns one package by exact scoped npm name.
• registry_status reports freshness, schema, endpoint, and verified count.
• absolute-agents://registry/index exposes the validated index as a resource.
• absolute-agents://packages/index exposes the validated package catalog.

All tools are marked read-only. Discovery never grants authorization: callers must follow each returned agent's advertised OAuth, approval, and delegation requirements before taking actions.

Library use

import { AgentRegistryClient, createAgentsMcpServer } from "@absolutejs/agents-mcp";

const registry = new AgentRegistryClient();
const results = await registry.search({ capability: "calendar", interfaceType: "a2a" });
const { server } = createAgentsMcpServer({ client: registry });

The npm package declares mcpName: io.github.absolutejs/agents and ships the official MCP Registry server.json metadata alongside its AbsoluteJS manifest.