AbsoluteJS

Agents MCP

@absolutejs/agents-mcpv0.2.2betaAI

Search verified agents and production agent-first AbsoluteJS packages from any MCP client.

#Installation

BASH
bun add @absolutejs/agents-mcp

#Capabilities

Overview

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

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.

Show 7 more

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

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

Outcomes

What you can build

Overview

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

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/

Hardening checklist

Production guidance

OverviewA 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.

Follow in order

Troubleshooting path

1
Trace from the first failed boundary
Reproduce the smallest canonical @absolutejs/agents-mcp example, confirm the supported entry point and version in the API explorer, then inspect the first boundary that did not produce its documented result.

#Run it

Partial snippet

Working example for Run it.

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

#Library use

Partial snippet

Working example for Library use.

TS
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 });

#Public entry points

Supported entry points declared by this project’s package manifest. Internal dist paths are not part of the package contract.

Public package entry point declared in package.json.

@absolutejs/agents-mcp@absolutejs/agents-mcp/manifest@absolutejs/agents-mcp/manifest.json

#Package commands

Scripts declared by this project’s package manifest.

bun run buildrm -rf dist && tsc -p tsconfig.build.json && absolute-manifest emit
bun run check:packagebun run typecheck && bun run test && bun run build && bun scripts/check-package.ts
bun run testbun test
bun run typechecktsc --noEmit

#API reference

Search the declarations exported by the current package type files. Expand a symbol to inspect its source-backed signature.

22 symbols
AgentRegistryClientexportPermalink
TS
AgentRegistryClient
Exported from @absolutejs/agents-mcp