About agents
@absolutejs/agents-mcp is a read-only discovery server for MCP clients searching the AbsoluteJS public registry for verified AI agents and production agent-first packages. It validates registry records and provides filters, detail lookups, and registry status information.
Key features
- 01Search agents by capability and interface
- 02Get agents by discovery ID or URL
- 03Search and retrieve AbsoluteJS packages
- 04Inspect registry status and verified counts
- 05Read indexes through MCP resources
Use cases
- 01Filter verified agents by capability
- 02Check an agent’s supported interfaces
- 03Find production-oriented AbsoluteJS packages
MCP support
It exposes read-only tools for searching and retrieving agent and package listings, plus MCP resources containing validated indexes. It can use a compatible federated registry.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
npx -y @absolutejs/agents-mcpABSOLUTE_AGENT_REGISTRY_URLOptional HTTPS URL of an AbsoluteJS-compatible registry index.ABSOLUTE_PACKAGE_REGISTRY_URLOptional HTTPS URL of an AbsoluteJS-compatible package index.Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.
Tools
5Saved tool list · updated 3w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| limit | integer | No | |
| query | string | No | Text found in agent metadata. |
| offset | integer | No | |
| capability | string | No | Capability ID or fragment. |
| interfaceType | enum | No | a2a | arazzo | http | mcp | openapi | webmcp | websocket |
Details
From the project README@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_agentsfilters verified listings by text, capability, and MCP/A2A/ Arazzo/WebMCP/HTTP/OpenAPI/WebSocket interface type, with bounded pagination.get_agentreturns one listing by canonical discovery ID or agent URL.search_packagesfilters the production AbsoluteJS catalog by purpose, category, and supported standard.get_packagereturns one package by exact scoped npm name.registry_statusreports freshness, schema, endpoint, and verified count.absolute-agents://registry/indexexposes the validated index as a resource.absolute-agents://packages/indexexposes 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.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.