---
title: "ENSIP-26 - how AI agents declare themselves on ENS with one identity across every chain"
description: "A new ENS standard gives every AI agent a single ENS name with an agent-context text record and protocol-specific endpoints via agent-endpoint records. The bridge between naming, registries and agent protocols."
date: 2026-11-06
reading_time: "5 min read"
url: https://myargoquest.com/blog/ensip-26-agent-text-records
markdown: https://myargoquest.com/blog/ensip-26-agent-text-records.md
publisher: Argo (myargoquest.com)
---

# ENSIP-26 - how AI agents declare themselves on ENS with one identity across every chain

# ENSIP-26: how AI agents declare themselves on ENS

An ENS name is a single, multichain identity. An agent running on Ethereum Mainnet, Base and Optimism should not need three identity files. It should have one name, one context file, and a way to say "connect to me here for this protocol, there for that one."

ENSIP-26 standardises exactly that, and it sits at the intersection of three of the most active areas in the Ethereum ecosystem right now: naming (ENS), agent identity (ERC-8004) and agent discovery (ENSIP-25).

![A five-step flow from ENS name through agent-context and agent-endpoint records to the client](https://myargoquest.com/blog/ensip-26-agent-text-records-1.jpg)
*An ENS name becomes an agent identity: one name, one context, protocol-specific endpoints. The client discovers everything through standard ENS text records.*

## History

ENSIP-26 was created on May 17, 2025 by premm.eth and justghadi.eth, and is currently in draft status. It extends ENSIP-5 (Text Records, the standard that lets any ENS name store arbitrary key-value text pairs) with two new keys: `agent-context` and `agent-endpoint[<protocol>]`.

The ecosystem around it: - **ENSIP-25** (AI Agent Registry ENS Name Verification) standardizes how agent registries verify that an ENS name owns an agent. - **ERC-8004** defines agent identity, reputation and validation onchain, and its "services" vocabulary is what ENSIP-26 uses for its protocol names. - **ENSIP-26** connects the two: an ENS name is the agent's identity, agent-context is the entry point (analogous to an index.html), and agent-endpoint records let clients connect directly to the running agent.

## What the two records do

**agent-context** is the agent's description file. It can be plain text, Markdown, YAML or JSON. It describes what the agent does, how to interact with it, and whether it is registered in any agent registries (ENSIP-25). It is the first thing a client loads when it wants to understand an agent.

**agent-endpoint[protocol]** maps a protocol name to a URL. The protocol names align with ERC-8004's service vocabulary. Three are defined today:

| Key | Protocol | Example value | |---|---|---| | `agent-endpoint[mcp]` | Model Context Protocol - tools, resources, prompts | `https://token-swap.mcp` | | `agent-endpoint[a2a]` | Agent-to-Agent Protocol - authentication, skills, messaging | `https://token-swap.a2a` | | `agent-endpoint[web]` | Human-facing web interface | `https://agent.example.com` |

Additional protocol values may be added as the ecosystem evolves. The value must be a valid URL, including IPFS URIs.

![Three rows showing agent-endpoint for mcp, a2a and web, each mapping to a URL](https://myargoquest.com/blog/ensip-26-agent-text-records-2.jpg)
*Each protocol name maps to a URL the client connects to.*

![A timeline showing the progression from ENSIP-5 to ENSIP-25 to ERC-8004 to ENSIP-26](https://myargoquest.com/blog/ensip-26-agent-text-records-3.jpg)
*The road to ENSIP-26: each layer adds one piece of the agent identity puzzle.*

## The example that makes it concrete

The specification includes a Swap Agent: an agent with one ENS identity that works across three chains (Ethereum Mainnet, Base and Optimism). Its agent-context describes the tokens it can swap and points to its endpoints. Its agent-endpoint records declare where to reach it via MCP and A2A.

A client that wants to interact with this agent loads the ENS name, reads `agent-context` to understand what the agent does, loads `agent-endpoint[mcp]` to get the connection URL, and connects over MCP. It does not need to know which chains the agent runs on. The agent's identity is the ENS name; the resolution handles the rest.

## The stack

ENSIP-26 does not stand alone. It sits in a stack where each layer handles one concern:

| Layer | Concern | |---|---| | ENS name | Identity, owned by whoever registered it | | ENSIP-25 | Verification: is this name really running this agent? | | **ENSIP-26** | Context and endpoint discovery - the bridge | | ERC-8004 | Protocol vocabulary and agent identity onchain | | MCP, A2A | Actual agent interaction (tools, skills, messages) |

![Five horizontal rows showing the stack from ENS name to agent protocols](https://myargoquest.com/blog/ensip-26-agent-text-records-4.jpg)
*ENSIP-26 sits at the center of the stack, bridging naming, verification and protocol layers.*

## Ideal use cases

The specification is intentionally minimal to encourage adoption. The ideal use cases follow from the design:

**Multichain agents.** An agent that runs on several rollups or L2s uses one ENS name, one context file, and per-chain endpoints if needed. The client resolves the name once and chooses the protocol.

**Wallets and dapps that interact with agents.** A wallet that supports ENS names can resolve an agent's MCP or A2A endpoints without a separate registry. The user types `vitalik.eth` and the wallet knows which protocols the agent speaks.

**Agent marketplaces and registries.** An agent registry (ENSIP-25) can read the agent-context from the ENS name instead of asking the developer to fill in a profile form separately. The name is the source of truth.

**Open-source agent frameworks.** A framework that spawns agents can give each agent an ENS name, write its context to the name's text records, and publish the endpoint when the agent is online. The agent's identity outlives any one session.

![Three use case cards for ENSIP-26: multichain agents, agent registries and wallet integration](https://myargoquest.com/blog/ensip-26-agent-text-records-5.jpg)
*ENSIP-26: ideal for multichain agents, agent registries that want to read the context directly, and wallets that resolve ENS names into agent protocols.*

## Backwards compatibility

Unaware clients ignore the new keys. Existing ENS name behaviour is unaffected. An ENS name that has never heard of ENSIP-26 resolves normally. Only clients that specifically look for agent-context and agent-endpoint will find them.

Security considerations are standard ENS security: the same rules that protect your domain control protect your agent's identity. The specification is at [docs.ens.domains/ensip/26](https://docs.ens.domains/ensip/26/) with the draft status meaning it can evolve as the ecosystem learns what works.
