AGT agent names
Resolve, verify and discover .agt agent names: owner, records, signed manifest, endpoints.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
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"
}
}
}
}Environment variables
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
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
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.
Frequently asked questions
What is AGT agent names?
Resolve, verify and discover .agt agent names: owner, records, signed manifest, endpoints.
How do I install AGT agent names?
It runs as a remote server. In Claude Code: claude mcp add --transport http agt-agent-names 'https://agtnames.com/api/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.
Does AGT agent names need an API key?
Yes. It expects AGT_SESSION_PASSPHRASE, which you set in its configuration.
Is AGT agent names open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains AGT agent names?
It is published by agtnames. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.