io.github.absolutejs/agents
Search verified agents and production agent-first AbsoluteJS packages.
Open source Open in the app JSON README (API)
About
Search verified agents and production agent-first AbsoluteJS packages.
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- absolutejs
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 0.2.0
- Last push
- 2026-07-23T11:21:55Z
- Repository state
- ativo
- Language
- TypeScript
- License
- MIT
- Added
- 2026-08-29 03:02:22
- Updated
- 2026-08-29 03:02:22
- Origin id
io.github.absolutejs/agents
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](https://absolutejs.github.io/agents/).
It gives MCP clients one installable discovery surface for agent names,
capabilities, protocols, publishers, authentication metadata, and signed
descriptors.
## Run it
```json
{
"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
```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 });
```
The npm package declares `mcpName: io.github.absolutejs/agents` and ships the
official MCP Registry `server.json` metadata alongside its AbsoluteJS manifest.