Skip to content
Open
Changes from 18 commits
Commits
Show all changes
21 commits
Select commit Hold shift + click to select a range
1548c12
Add ENSIP-TBD-11 from the main branch of ENSIP-ideas repository (http…
nxt3d May 22, 2025
45dde5f
Update ENSIP-TBD-11 to standardize the `llms-txt` text record key for…
nxt3d May 30, 2025
88ee00f
Update title in ENSIP-TBD-11 to standardize naming convention for the…
nxt3d May 30, 2025
db7abb0
Refine llms.txt format in ENSIP-TBD-11 by removing ENS-specific adapt…
nxt3d May 30, 2025
98c1940
Clarify section headings in ENSIP-TBD-11 by renaming "Optional H2 Sec…
nxt3d May 30, 2025
fa95aa7
Remove redundant security considerations in ENSIP-TBD-11, clarifying …
nxt3d May 30, 2025
69b8e49
Add RFC 2119 terminology clarification and reintroduce rationale in E…
nxt3d May 30, 2025
5f62201
Enhance ENSIP-TBD-11 by introducing the llms-agent text record alongs…
nxt3d Jun 3, 2025
608cf5c
Return to the commit e616468b9adf76aaa9d88badaac4c8c770908f70, while …
nxt3d Jun 10, 2025
1fc7b59
Enhance ENSIP-TBD-11 by expanding the `root-context` text record spec…
nxt3d Jun 10, 2025
f30ee33
Enhance Markdown usage in ENSIP-TBD-11 by adding fenced code blocks f…
nxt3d Jun 10, 2025
356a114
feat: Head section in root-context interfaces
Ghadi8 Jun 11, 2025
516fb08
feat: simplify ensip to define only root-context key
Ghadi8 Jun 19, 2025
4ed460b
Rename root-context to agent-context and add registry/protocol discovery
nxt3d Nov 12, 2025
be9b031
Rename ensip-TBD-11.md to agent-context-record.md
nxt3d Nov 12, 2025
5d2df39
Update header style to match ENSIP-24 format
nxt3d Nov 12, 2025
d5840b4
ENSIP-26: Agent-Context Text Record
nxt3d Feb 16, 2026
232a173
Add index.html analogy: agent-context as starting point for AI agent
nxt3d Feb 25, 2026
88384f3
Add Agent Resolution section: load agent-context, read content
nxt3d Feb 25, 2026
79c8f2d
Add agent-endpoint records and multichain agent identity model
nxt3d Mar 11, 2026
e4dcecc
Rename to Agent Text Records
nxt3d Mar 11, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
70 changes: 70 additions & 0 deletions ensips/26.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,70 @@
---
title: Agent‑Context Text Record
description: A standardized text record for agent context and verified agentic data.
contributors:
- premm.eth
- justghadi.eth
ensip:
created: "2025-05-17"
status: draft
---

# ENSIP-26: Agent-Context Text Record

## Abstract

This ENSIP extends ENSIP‑5: Text Records by standardizing the `agent-context` text record key. The key gives agentic systems a single place to discover context for an ENS name. An agent may be registered in many registries on many chains while still sharing one context: for instance, a swapping agent on multiple chains can publish a single, unified token list in its `agent-context` record.

## Motivation

Agentic systems require verifiable context data. ENS names provide an onchain, verifiable location for this data. This ENSIP standardizes discovery via the `agent-context` text record, eliminating the need for managing context data across multiple registries.

## Specification

The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in RFC 2119.

### Text Record Key

- **Key**: `agent-context`
- **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?

### Example: Swap Agent Token List

A swap agent may use the `agent-context` record to publish a unified list of tokens it supports, each with a smart contract address and chain ID. Clients can resolve this record once and discover all supported tokens across chains.

```markdown
# Swap Agent

I am a swapping agent that can do swaps on multiple chains. My registered chains can be found using ENSIP-25 `agent-registration` records. My verified tokens that I can swap include:

| Symbol | Chain ID | Address |
|--------|----------|---------|
| WETH | 1 | 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2 |
| WETH | 8453 | 0x7c6b91D9Be1559ADb2fB92A2e0eEecf5e3f4B5c6 |
| USDC | 1 | 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 |
| USDC | 8453 | 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 |
| DAI | 1 | 0x6B175474E89094C44Da98b954EedeAC495271d0F |
| DAI | 8453 | 0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb |
```

## Backwards Compatibility

Unaware clients will ignore the new key; existing behavior is unaffected.

## Security Considerations

There are no security considerations specific to this ENSIP. Standard ENS security considerations apply to the underlying text record functionality.

## Rationale

This ENSIP creates a standardized entry point for discovering agent context. The `agent-context` record is analogous to `index.html` in a web application: it is the starting point for interactions with the AI agent. By defining only the key and leaving the value format flexible, it enables experimentation while ensuring interoperability.

The `agent-context` key serves as a well-known location for agentic systems, reducing the need for ad hoc discovery mechanisms. As the ecosystem evolves with competing standards, the ability to express preferences becomes essential for optimizing interactions while maintaining client flexibility.

Future ENSIPs may define more specific formats, but this specification intentionally remains minimal to encourage adoption and experimentation.

## Copyright

Copyright and related rights waived via [CC0](https://creativecommons.org/publicdomain/zero/1.0/).