Skip to content

Add ENSIP-26: Agent Text Records#65

Open
nxt3d wants to merge 21 commits intoensdomains:masterfrom
nxt3d:agent-context
Open

Add ENSIP-26: Agent Text Records#65
nxt3d wants to merge 21 commits intoensdomains:masterfrom
nxt3d:agent-context

Conversation

@nxt3d
Copy link
Contributor

@nxt3d nxt3d commented Feb 16, 2026

Description

This PR adds ENSIP-26, which standardizes two ENS text record keys for AI agent identity: agent-context and agent-endpoint[<protocol>]. Together they give agentic systems a single, well-known place to discover and connect to an agent across chains.

Key points

  • agent-context (ENSIP-5 text record) — any format (plain text, Markdown, YAML, JSON); the entry point describing the agent and how to interact with it. May reference agent registries (ENSIP-25) or agent-endpoint records.
  • agent-endpoint[<protocol>] — protocol-specific connection URLs. Supported protocols aligned with ERC-8004: mcp, a2a, oasf, web. Values may be https://, http://, or ipfs:// URIs.
  • Example: Swap Agent with a multichain token list (Ethereum, Base, Optimism) and MCP/A2A endpoints.
  • Client behavior: Resolve agent-context for context and identity, then optionally load agent-endpoint records to connect.

Rationale

An ENS name is the agent's single multichain identity. Defining only the keys and leaving value formats flexible allows experimentation while providing a stable discovery entry point. More structured formats can be specified in future ENSIPs.

nxt3d and others added 17 commits November 12, 2025 09:26
… AI-friendly manifests, replacing the previous `root-context` key. This change aligns with the llms.txt standard, enhancing compatibility for AI systems and providing a structured format for interaction definitions.
…ations and clarifying interface definitions. Introduce example usage for better understanding of the text record's application in AI interactions.
…tions" to "File Lists of URLs" to better reflect content structure and enhance understanding of additional context provided.
…that there are no specific security concerns related to this ENSIP.
…NSIP-TBD-11 to enhance understanding of the llms.txt standard's application and its compatibility with existing tools.
…ide llms-txt. Update specifications to clarify interface definitions and their applications, ensuring compatibility with emerging AI standards.
…ification to support multiple agentic system interfaces. Introduce structured formats for defining interfaces, including chat, agent, and tools, while clarifying the expected manifest content and usage. This update aims to standardize AI context discovery and interaction methods across ENS names, improving interoperability and developer experience.
…or JSON examples, improving clarity and formatting for interface specifications.
- Rename Root-Context to Agent-Context throughout the document
- Add Agent Registry Discovery section (e.g., ERC-8004)
- Add Protocol Support Discovery section (e.g., x402, A2A)
- Add Multi-Protocol Support Preferences section
- Condense and tighten language throughout for clarity
- Update client resolution flow to include preference handling
Rename agent-context-record.md to 26.md and assign ENSIP number 26.

This ENSIP standardizes the agent-context text record key (ENSIP-5) as a
single place for agentic systems to discover context for an ENS name.
Agents can be registered on multiple chains while publishing one shared
context (e.g. a swap agent's unified token list with chain ID and
contract address per token).

Specification includes:
- Text record key and format (any format: plain text, Markdown, YAML, JSON)
- Example: swap agent with Markdown intro and verified token table
  (WETH, USDC, DAI on chains 1 and 8453)
- Client resolution flow
- Backwards compatibility, security, rationale

Co-authored-by: Cursor <[email protected]>
@jmacwhyte
Copy link

Does this work the same as ERC-8004's agentURI? Putting myself in the shoes of a developer looking at this document without much background, I don't think it has sufficient detail for me to understand what I can do with it.

@nxt3d
Copy link
Contributor Author

nxt3d commented Feb 25, 2026

Does this work the same as ERC-8004's agentURI? Putting myself in the shoes of a developer looking at this document without much background, I don't think it has sufficient detail for me to understand what I can do with it.

I had a versioning issue, take a look at this latest version.

- **Format**: Any format suitable for agentic systems (plain text, Markdown, YAML, JSON, etc.)

The key **MUST** be published via `text(bytes32,string)` as defined in ENSIP‑5. The content MAY describe what the ENS name represents and how to interact with it.

Copy link

@jmacwhyte jmacwhyte Feb 25, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't understand what mechanism is being standardized here. This section basically boils down to "a specific key name may or may not exist, and if it does, it could contain any value".

Could you explain a bit more why this needs to be formalized as an ENSIP? Isn't "describe what the ENS name represents" already possible with the description key defined in ENSIP-5?

Introduce agent-endpoint[<protocol>] text records aligned with ERC-8004
services: mcp, a2a, oasf, web. Values may be https://, http://, or
ipfs:// URIs. Reframe ENSIP-26 around a single multichain ENS identity:
agent-context is the entry point pointing to registry or endpoint
discovery. Update examples to use a generic Swap Agent with multichain
token list across Ethereum, Base, and Optimism.

Made-with: Cursor
@nxt3d nxt3d changed the title Add ENSIP-26: Agent-Context Text Record Add ENSIP-26: Agent Text Records Mar 11, 2026
Made-with: Cursor
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants