Skip to content

Add agent-readiness discovery surfaces and MCP guide #16

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
mikedotexe wants to merge 6 commits into from
Closed

Add agent-readiness discovery surfaces and MCP guide #16

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
48571ca
Add agent-readiness discovery surfaces and MCP guide
mikedotexe Apr 18, 2026
68b3620
Fix MCP guide startup instructions
mikedotexe Apr 18, 2026
b7faa25
Refine MCP guide block summary and generic config guidance
mikedotexe Apr 18, 2026
ceb617c
Tighten snapshot and transaction guidance
mikedotexe Apr 18, 2026
9e92305
Refine snapshot operator guidance
mikedotexe Apr 18, 2026
36d2677
Clarify boot node refresh for snapshot bootstrap
mikedotexe Apr 18, 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
1 change: 1 addition & 0 deletions docs/agents/auth-for-agents.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -101,3 +101,4 @@ When auth is relevant, a useful agent answer usually contains:
- [Auth & Access](/auth)
- [Agents on FastNear](/agents)
- [Choosing the Right Surface](/agents/choosing-surfaces)
- [Building an MCP Server with FastNear](/agents/mcp)
3 changes: 3 additions & 0 deletions docs/agents/choosing-surfaces.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,8 @@ Do not start by exposing every FastNear API to an agent. Start by translating th

For agents, the important question is usually not "which endpoint exists?" It is "what kind of answer will help the user next?"

If your task is designing an MCP tool set rather than routing one user request, use [Building an MCP Server with FastNear](/agents/mcp).

## What decides the route

Before you pick an API, identify four things:
Expand Down Expand Up @@ -263,3 +265,4 @@ The goal is not to prove that multiple FastNear APIs exist. The goal is to answe
- [Agents on FastNear](/agents) for the full surface map, base URLs, and prompt-ingestion hints.
- [Auth for Agents](/agents/auth) for credential handling and runtime posture.
- [Agent Playbooks](/agents/playbooks) for example multi-step workflows.
- [Building an MCP Server with FastNear](/agents/mcp) for a recommended first tool set and a direct-HTTP TypeScript example.
2 changes: 2 additions & 0 deletions docs/agents/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,7 @@ This page is the operational starting point for AI agents, crawlers, and automat
- Need to decide which FastNear API to start with? Use [Choosing the Right Surface](/agents/choosing-surfaces).
- Need credential handling rules? Use [Auth for Agents](/agents/auth).
- Need example multi-step workflows? Use [Agent Playbooks](/agents/playbooks).
- Need to expose FastNear to Claude Desktop, Codex, Cursor, or another MCP client? Use [Building an MCP Server with FastNear](/agents/mcp).
- Need exact endpoint docs now? Go directly to [RPC Reference](/rpc), [FastNear API](/api), [Transactions API](/tx), [Transfers API](/transfers), [NEAR Data API](/neardata), or [KV FastData API](/fastdata/kv).

## FastNear for agents in one minute
Expand Down Expand Up @@ -145,3 +146,4 @@ Avoid dumping raw payloads when the user is really asking for interpretation.
- Need routing depth and tradeoffs? [Choosing the Right Surface](/agents/choosing-surfaces)
- Need credential posture and secret handling? [Auth for Agents](/agents/auth)
- Need example workflows? [Agent Playbooks](/agents/playbooks)
- Need to build your own MCP tool surface on top of FastNear? [Building an MCP Server with FastNear](/agents/mcp)
Loading
Loading