English Français العربية

AGT agent names

السجل الرسمي الأمن

Resolve, verify and discover .agt agent names: owner, records, signed manifest, endpoints.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http agt-agent-names 'https://agtnames.com/api/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "agt-agent-names": {
            "type": "http",
            "url": "https://agtnames.com/api/mcp"
        }
    }
}
NPM package @agtnames/mcp
Claude Code 
claude 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
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "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"
            }
        }
    }
}

متغيرات البيئة

  • AGT_CHAIN Chain to read: polygon (mainnet, needs nothing else), amoy or localhost.
  • AGT_RPC_URL Override the JSON-RPC endpoint for the selected chain.
  • AGT_REGISTRY Override the registry contract address (required only for localhost or a custom deployment).
  • AGT_IPFS_GATEWAY Pin ipfs:// manifest reads to one allow-listed gateway; unset walks pinata, dweb.link, ipfs.io, w3s.link, cloudflare-ipfs in order.
  • AGT_TIMEOUT_MS Per-request timeout for RPC and IPFS calls, in milliseconds.
  • AGT_RATE_PER_MIN Tool calls per minute before the server answers rate_limited.
  • AGT_SESSION_PASSPHRASE سري 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_DIR Directory for the encrypted session key and imported grant.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. agt — open-source packages for .agt agent names
  2. Registry listings
  3. Development
  4. Security and contributing

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.

PathWhatInstall
packages/resolver@agtnames/resolver: resolve, verify and read manifests; A2A agent card and ERC-8004 export helpers; agt-resolve CLInpm 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 keynpx @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/mcpnpx -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-namesAgent skill teaching when and how to use the tools and the public APInpx skills add agtnames/agt
spec/The .agt manifest specification (v3 draft, v1 frozen); rendered at agtnames.com/spec
gemini-extension.jsonGemini CLI extension bundling the MCP servergemini 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.

الأسئلة الشائعة

ما هو AGT agent names؟

Resolve, verify and discover .agt agent names: owner, records, signed manifest, endpoints.

كيف أثبّت AGT agent names؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http agt-agent-names 'https://agtnames.com/api/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج AGT agent names إلى مفتاح API؟

نعم. يتطلب AGT_SESSION_PASSPHRASE، وتضبطها في إعداداته.

هل AGT agent names مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون AGT agent names؟

ينشره agtnames. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.