docs(agents): add an AI resources page by GigaHierz · Pull Request #2395 · celo-org/docs

GigaHierz · 2026-10-15T22:26:55Z

Part of #2261 (third of three PRs).

What the docs offer AI tools is spread across use-docs-with-ai, Celopedia, the MCP pages and the protocol pages. This adds one page that lists all of it with a line on when to use each.

Changes

New build/agents/ai-resources.mdx with four tables: resources in the docs (assistant, /mcp, llms.txt, llms-full.txt, .md export, contextual menu, the skill.md docs skill), Celo tooling for agents (Celopedia, Celo MCP server), third-party tools (vibe coding tools, Celina, Agent Vault) and protocols for agents (x402, MPP, ERC-8004, Self Agent ID). Every row links to the page that explains it, and the docs rows link to their sections in use-docs-with-ai; the page restates no setup steps.
The docs skill row says how to get it: npx skills add https://docs.celo.org (checked: it discovers the celo skill), or through an MCP client connected to /mcp.
Added to the Agents nav group after use-docs-with-ai.
use-docs-with-ai links to it from its Related cards, and the agents overview has a Related section that links both pages.
AGENTS.md: the AI tooling row lists /build/agents/ai-resources, and rule 9 now names it as a page new agent-relevant pages get listed on.

The homepage card for this page is not included: it would conflict with #2393, which rewrites the same file. Add it in a small follow-up once both merge.

Rebased onto main after #2396 merged: both nav entries sit after use-docs-with-ai, and the agent-wallet page is listed under Related here, as AGENTS.md rule 9 asks.

Verification

mint validate passes on this branch; mint broken-links and python3 scripts/check_redirects.py passed earlier with no problems.
Every endpoint and capability on the page is taken from use-docs-with-ai and the linked pages, not restated from elsewhere.

🤖 Generated with Claude Code

palango

A single page for this is useful and it sits in the right group. The links resolve: llms.txt and llms-full.txt return 200, /mcp answers tools/list over POST, and the .md export works. A few rows say more than is true, though, and those need fixing before merge.

The contextual menu row says you can open a page in Cursor or VS Code. In Mintlify those two options are "Connect to Cursor" and "Connect to VS Code" and they install the docs MCP server; only ChatGPT and Claude open the page (https://mintlify.com/docs/ai/contextual-menu). use-docs-with-ai already words this correctly.

The ERC-8004 row mentions validation, but Celo only has the Identity and Reputation registries. Our 8004 page and the erc-8004-contracts README both list just those two.

The issue asks for the installable skills, and the page leaves out the one we already serve: docs.celo.org/skill.md is live (Mintlify generates it), and no page mentions it yet, so this is the natural place. Agent Vault from #2392 is missing too. Without those, "Every way" in the description overclaims.

Smaller things are inline. Also, AGENTS.md rule 9 says agent pages get listed on /build/agents/overview, which links neither this page nor use-docs-with-ai, and the AI tooling row at AGENTS.md line 129 could point at the new page now that it exists.

Heads up that #2396 adds its nav entry on the same line of docs.json, so whichever of the two merges second needs a quick rebase.

palango · 2026-10-19T08:08:34Z

@@ -0,0 +1,43 @@
+---
+title: "AI Resources"
+sidebarTitle: "AI Resources"


Same as the title, so this can go (AGENTS.md: only when the nav label must be shorter).

palango · 2026-10-19T08:08:35Z

+---
+title: "AI Resources"
+sidebarTitle: "AI Resources"
+description: Every way docs.celo.org and Celo tooling serve AI tools and agents, with one line on when to use each


"Every way" isn't quite true yet: docs.celo.org/skill.md and Agent Vault aren't on the page. Either add them or drop "Every".

palango · 2026-10-19T08:08:35Z

+
+| Resource | Where | Use it to |
+|----------|-------|-----------|
+| Docs assistant | **Ask AI** button on any page | Ask a question and get an answer with links to the pages it used |


These rows restate the table at the top of use-docs-with-ai and, unlike the other two tables, don't link anywhere. Could each row link to its section there (#ask-a-question-in-the-docs, #connect-the-docs-mcp-server, #llms-txt-and-llms-full-txt, #copy-any-page-as-markdown)? Then this page stays an index and the two tables are less likely to drift.

palango · 2026-10-19T08:08:35Z

+| `llms.txt` | [`docs.celo.org/llms.txt`](https://docs.celo.org/llms.txt) | Give a chat a map of every docs page |
+| `llms-full.txt` | [`docs.celo.org/llms-full.txt`](https://docs.celo.org/llms-full.txt) | Load the whole docs set into a long-context model |
+| Page as Markdown | Append `.md` to any docs URL | Quote one page as context in a script or agent |
+| Contextual menu | Next to every page title | Copy a page, view it as Markdown, or open it in ChatGPT, Claude, Cursor or VS Code |


Cursor and VS Code don't open the page. In Mintlify those options are "Connect to Cursor" and "Connect to VS Code", and they install the docs MCP server (https://mintlify.com/docs/ai/contextual-menu). Suggest: "Copy a page, view it as Markdown, open it in ChatGPT or Claude, or install the docs MCP server in Cursor or VS Code".

palango · 2026-10-19T08:08:35Z

+| `llms-full.txt` | [`docs.celo.org/llms-full.txt`](https://docs.celo.org/llms-full.txt) | Load the whole docs set into a long-context model |
+| Page as Markdown | Append `.md` to any docs URL | Quote one page as context in a script or agent |
+| Contextual menu | Next to every page title | Copy a page, view it as Markdown, or open it in ChatGPT, Claude, Cursor or VS Code |
+


A row for the docs skill would fit here: https://docs.celo.org/skill.md, generated by Mintlify (https://mintlify.com/docs/ai/skillmd). Nothing else in the docs mentions it.

palango · 2026-10-19T08:08:35Z

+|----------|------------------------|------|
+| Celopedia | A skill with curated Celo knowledge: contract addresses, MiniPay, DeFi, grants and agent infrastructure | [Celopedia](/build/agents/celopedia) |
+| Celo MCP server | Live chain data: balances, blocks, gas fees, governance and staking | [Celo MCP server](/build/agents/mcp/celo-mcp) |
+| Celina | A wallet on Celo for an LLM: balances, transfers, DeFi, governance, staking and Self Agent ID | [Celina](/build/agents/mcp/celina) |


Celina is third-party (celina.mdx line 7). Worth saying so here, since the heading reads as Celo-built tooling.

palango · 2026-10-19T08:08:35Z

+|----------|--------------|------|
+| x402 | Charge or pay per HTTP request in stablecoins | [x402](/build/agents/x402) |
+| MPP | Charge per API request, settled through the Celo facilitator | [MPP](/build/agents/mpp) |
+| ERC-8004 | Register an agent identity, reputation and validation onchain | [ERC-8004](/build/agents/8004) |


Celo only has the Identity and Reputation registries (see Contract Deployments on the 8004 page), and reputation is feedback other parties post. Something like "Register an agent onchain so other agents can find and rate it" matches the 8004 page.

GigaHierz · 2026-10-19T09:05:49Z

Rebased and addressed the review: dropped sidebarTitle, dropped "Every" from the description, linked the docs rows to their sections in use-docs-with-ai (anchors checked against the live page), corrected the contextual menu and ERC-8004 rows, added the docs skill row and Agent Vault, marked Celina and Agent Vault as third-party, and linked the page from the agents overview (new Related section) and the AGENTS.md AI tooling row. The #2396 docs.json conflict is gone after the rebase.

palango

Thanks, this covers everything from my last round. The contextual menu and ERC-8004 rows are correct now, and the docs rows link to their sections (I checked the anchors against the live page). skill.md and Agent Vault are listed, the third-party split reads well, and the overview links both pages. A few things are left, including the three inline comments, and I'd like them fixed before this goes in.

The docs.json conflict with #2396 is still there. Both branches insert a line right after build/agents/use-docs-with-ai, and git merge-tree --write-tree pr/2395 pr/2396 reports a conflict in docs.json, so whichever merges second needs a rebase. Once both are in, AGENTS.md rule 9 wants the agent-wallet page listed here too.

Rule 9 itself (AGENTS.md line 157) still says "when it exists, the AI-resources page (#2261)". The page exists now, so it can name /build/agents/ai-resources.

The PR body still describes the first version (three tables, Celina under Celo tooling) and doesn't mention the overview and AGENTS.md changes.

palango · 2026-10-19T09:16:55Z

+|----------|------------------------|------|
+| Celopedia | A skill with curated Celo knowledge: contract addresses, MiniPay, DeFi, grants and agent infrastructure | [Celopedia](/build/agents/celopedia) |
+| Celo MCP server | Live chain data: balances, blocks, gas fees, governance and staking | [Celo MCP server](/build/agents/mcp/celo-mcp) |
+| Vibe coding tools | AI-assisted development tools that work for building on Celo | [Vibe coding tools](/build/agents/vibe-coding) |


The vibe coding page lists Bolt, Lovable, Replit, Cursor, Windsurf and a couple of third-party MCP servers, so this row fits the new third-party section better than "Celo tooling". It's also tooling for the developer rather than the agent.

palango · 2026-10-19T09:16:55Z

+| [`llms.txt` and `llms-full.txt`](/build/agents/use-docs-with-ai#llms-txt-and-llms-full-txt) | [`docs.celo.org/llms.txt`](https://docs.celo.org/llms.txt), [`docs.celo.org/llms-full.txt`](https://docs.celo.org/llms-full.txt) | Give a chat a map of every docs page, or load the whole docs set into a long-context model |
+| [Page as Markdown](/build/agents/use-docs-with-ai#copy-any-page-as-markdown) | Append `.md` to any docs URL | Quote one page as context in a script or agent |
+| [Contextual menu](/build/agents/use-docs-with-ai#copy-any-page-as-markdown) | Next to every page title | Copy a page, view it as Markdown, open it in ChatGPT or Claude, or install the docs MCP server in Cursor or VS Code |
+| Docs skill | [`docs.celo.org/skill.md`](https://docs.celo.org/skill.md) | Give an agent that loads skills a summary of what the docs cover and when to use them |


Mintlify describes skill.md as a summary of what an agent can do with the product, which matches the live file, rather than of what the docs cover. It would also help to say how to get it. MCP clients that connect to /mcp load it as a resource, and Mintlify documents npx skills add <docs url> for everything else (https://mintlify.com/docs/ai/skillmd). /.well-known/skills/index.json is live, but please run the command once before adding it.

palango · 2026-10-19T09:16:55Z


 <CardGroup cols={2}>
+  <Card title="AI Resources" icon="sparkles" href="/build/agents/ai-resources">
+    Every AI-facing resource the docs and Celo tooling offer, in one list.


This card still says "Every", the word you already took out of the description. Maybe "The AI-facing resources the docs and Celo tooling offer, in one list."

GigaHierz · 2026-10-20T16:30:10Z

Pushed the remaining points: card wording on use-docs-with-ai, AGENTS.md rule 9 names /build/agents/ai-resources, the skill row says it summarises what an agent can do with Celo and how to install it (npx skills add https://docs.celo.org, checked: it finds the celo skill), vibe coding moved to a third-party section, and the PR body is updated. The docs.json conflict with #2396 is still there: both add a line after use-docs-with-ai, so whichever merges second needs a one-line rebase. Rule 9 also wants the agent-wallet page listed here once #2396 is in.

List every AI-facing resource in one place: the docs assistant, MCP endpoint, llms.txt files, Markdown export, contextual menu, Celopedia, the Celo MCP server, Celina and the agent protocols. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

Link the docs rows to their sections, correct the contextual menu and ERC-8004 rows, add the docs skill and Agent Vault, mark third-party tools, and link the page from the agents overview and AGENTS.md. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

GigaHierz · 2026-10-20T17:12:28Z

Rebased onto main after #2396 merged. The docs.json conflict is resolved (both nav entries kept), the agent-wallet page is listed under Related, and mint validate and mint broken-links pass. Body updated.

palango

Thanks, everything from both rounds is in. The contextual menu, ERC-8004 and skill rows are right, the install line matches Mintlify's skill.md docs, vibe coding sits with the third-party tools, and rule 9 names the page. The section anchors resolve on the live page and CI is green.

One thing came in with the rebase: AskBots (#2387) merged yesterday, and by rule 9 it should be listed here too. A row in the Celo tooling table would do, since its page says the Celo team built it. Also, #2393 has merged, so the homepage card you held back can go in whenever you like.

palango · 2026-10-21T08:25:29Z

+| Resource | What it gives an agent | Page |
+|----------|------------------------|------|
+| Celopedia | A skill with curated Celo knowledge: contract addresses, MiniPay, DeFi, grants and agent infrastructure | [Celopedia](/build/agents/celopedia) |
+| Celo MCP server | Live chain data: balances, blocks, gas fees, governance and staking | [Celo MCP server](/build/agents/mcp/celo-mcp) |


AskBots (#2387) landed on main yesterday and isn't on this page yet, which rule 9 asks for. Something like | AskBots | Paid reviews: builders fund questions in USDT and agents earn per accepted answer | [AskBots](/build/agents/askbots) | after this row would fit, since the AskBots page says the Celo team built it.

GigaHierz requested a review from a team as a code owner October 15, 2026 22:26

This was referenced Oct 15, 2026

Epic: Docs restructure — 7 tabs → Learn / Build / Operate / Contribute #2266

Open

story: Homepage, Contribute rename, and an "AI resources" page — final pass #2261

Open

GigaHierz assigned palango Oct 15, 2026

palango requested changes Oct 19, 2026

View reviewed changes

palango mentioned this pull request Oct 19, 2026

docs(agents): add a page for giving an agent a wallet and test funds #2396

Merged

GigaHierz force-pushed the docs/ai-resources-page branch from 5023efd to 08800df Compare October 19, 2026 09:03

palango requested changes Oct 19, 2026

View reviewed changes

GigaHierz and others added 4 commits October 20, 2026 19:11

docs(agents): finish review on the AI resources page

1840adc

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

docs(agents): list the agent wallet page on the AI resources page

99be94e

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

GigaHierz force-pushed the docs/ai-resources-page branch from bf5bdf5 to 99be94e Compare October 20, 2026 17:12

palango approved these changes Oct 21, 2026

View reviewed changes

GigaHierz merged commit d9854b8 into main Oct 21, 2026
5 checks passed

GigaHierz deleted the docs/ai-resources-page branch October 21, 2026 22:19

Conversation

GigaHierz commented Oct 15, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Changes

Verification

Uh oh!

palango left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

GigaHierz commented Oct 19, 2026

Uh oh!

palango left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

GigaHierz commented Oct 20, 2026

Uh oh!

GigaHierz commented Oct 20, 2026

Uh oh!

palango left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

GigaHierz commented Oct 15, 2026 •

edited

Loading