AGT agent names
Resolve, verify and discover .agt agent names: owner, records, signed manifest, endpoints.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
claude mcp add --transport http agt-agent-names 'https://agtnames.com/api/mcp'{
"mcpServers": {
"agt-agent-names": {
"type": "http",
"url": "https://agtnames.com/api/mcp"
}
}
}@agtnames/mcpclaude mcp add agt-agent-names -e 'AGT_CHAIN=polygon' -e 'AGT_RPC_URL=<AGT_RPC_URL>' -e 'AGT_REGISTRY=<AGT_REGISTRY>' -e 'AGT_IPFS_GATEWAY=<AGT_IPFS_GATEWAY>' -e 'AGT_TIMEOUT_MS=10000' -e 'AGT_RATE_PER_MIN=240' -e 'AGT_SESSION_PASSPHRASE=<your agt_session_passphrase>' -e 'AGT_SESSION_DIR=~/.agt/session' -- npx -y @agtnames/mcp@1.5.2{
"mcpServers": {
"agt-agent-names": {
"command": "npx",
"args": [
"-y",
"@agtnames/mcp@1.5.2"
],
"env": {
"AGT_CHAIN": "polygon",
"AGT_RPC_URL": "<AGT_RPC_URL>",
"AGT_REGISTRY": "<AGT_REGISTRY>",
"AGT_IPFS_GATEWAY": "<AGT_IPFS_GATEWAY>",
"AGT_TIMEOUT_MS": "10000",
"AGT_RATE_PER_MIN": "240",
"AGT_SESSION_PASSPHRASE": "<your agt_session_passphrase>",
"AGT_SESSION_DIR": "~/.agt/session"
}
}
}
}Variables d'environnement
AGT_CHAINChain to read: polygon (mainnet, needs nothing else), amoy or localhost.AGT_RPC_URLOverride the JSON-RPC endpoint for the selected chain.AGT_REGISTRYOverride the registry contract address (required only for localhost or a custom deployment).AGT_IPFS_GATEWAYPin ipfs:// manifest reads to one allow-listed gateway; unset walks pinata, dweb.link, ipfs.io, w3s.link, cloudflare-ipfs in order.AGT_TIMEOUT_MSPer-request timeout for RPC and IPFS calls, in milliseconds.AGT_RATE_PER_MINTool calls per minute before the server answers rate_limited.AGT_SESSION_PASSPHRASEsecret Optional, 12+ characters. Enables the countersign write tools (agt_session_*, agt_set_*); the local session key is stored encrypted under AGT_SESSION_DIR.AGT_SESSION_DIRDirectory for the encrypted session key and imported grant.
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Sommaire
agt — open-source packages for .agt agent names
.agt names give AI agents a resolvable identity on Polygon: an owner, on-chain records, a signed manifest and endpoints (MCP, A2A, HTTP). This repository holds the public packages, the agent skill, the manifest specification and the registry manifests behind agtnames.com.
| Path | What | Install |
|---|---|---|
packages/resolver | @agtnames/resolver: resolve, verify and read manifests; A2A agent card and ERC-8004 export helpers; agt-resolve CLI | npm i @agtnames/resolver |
packages/cli | @agtnames/cli: the agt command. Register a name, publish its signed manifest, set records and verify, from a terminal; signs in MetaMask through a local page, or with an env or encrypted key | npx @agtnames/cli --help |
packages/mcp | @agtnames/mcp: MCP server (stdio) with five read-only tools; the hosted Streamable-HTTP endpoint is https://agtnames.com/api/mcp | npx -y @agtnames/mcp · claude mcp add --transport http agt https://agtnames.com/api/mcp |
packages/countersign | @agtnames/countersign: scoped session grants for record writes (EIP-7702 + Delegation Framework caveats) | npm i @agtnames/countersign |
packages/snap | @agtnames/snap: MetaMask Snap that resolves name.agt in the send field to the name's on-chain address (Polygon and the major EVM chains) | MetaMask Flask until allowlisted: wallet_requestSnaps with npm:@agtnames/snap |
skills/agt-names | Agent skill teaching when and how to use the tools and the public API | npx skills add agtnames/agt |
spec/ | The .agt manifest specification (v3 draft, v1 frozen); rendered at agtnames.com/spec | |
gemini-extension.json | Gemini CLI extension bundling the MCP server | gemini extensions install https://github.com/agtnames/agt |
Docs: agtnames.com/docs · Claude Code and other clients: /docs/claude-code · framework snippets: /docs/integrations.
Registry listings
The MCP server is listed in the official MCP registry as com.agtnames/agt (packages/mcp/server.json), on Smithery (packages/mcp/smithery.yaml) and wherever else packages/mcp/README.md "Listed in" records.
Development
Each package is its own npm project: cd packages/<name> && npm ci && npm run build && npm test. packages/mcp links its siblings with file: dependencies, so build resolver and countersign first. packages/cli depends on the published resolver (a registry range; its prepublishOnly refuses file:), so publish a resolver change first. packages/snap is bundled by mm-snap (its snap.manifest.json carries the bundle shasum; npm run manifest:check must pass before a commit) and tested with @metamask/snaps-jest. .github/workflows/ci.yml runs the same steps plus node scripts/check-skills.mjs.
Releases: tag resolver-v*, countersign-v*, cli-v*, mcp-v* or snap-v* (or run the release workflow by hand with dry_run). The workflow publishes every package whose version is not on npm yet through npm trusted publishing with provenance, then re-lists the MCP server with mcp-publisher (DNS-verified namespace). A new Snap version must also be re-submitted to the MetaMask Snaps Directory by hand. See the header of .github/workflows/release.yml.
Security and contributing
Vulnerabilities: see SECURITY.md. Issues and pull requests for anything in this repository are welcome here; see CONTRIBUTING.md. Questions about the agtnames.com service itself go to the contact addresses on the site.
MIT, © 2026 AGT Domains LLC.
Questions fréquentes
Qu'est-ce que AGT agent names ?
Resolve, verify and discover .agt agent names: owner, records, signed manifest, endpoints.
Comment installer AGT agent names ?
Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http agt-agent-names 'https://agtnames.com/api/mcp'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour AGT agent names ?
Oui. Il attend AGT_SESSION_PASSPHRASE, à renseigner dans sa configuration.
AGT agent names est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient AGT agent names ?
Il est publié par agtnames. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.