What is mattwood.fyi?

A live, structured feed of riffs and links from Matt Wood, Chief AI & Technology Officer at AWS — readable by people and queryable by agents as a typed knowledge graph.

Is there an API and is it free?

Yes. A public, read-only query API is available with no authentication and no API keys. See https://mattwood.fyi/openapi.json and https://mattwood.fyi/docs.

How should an AI agent use this site?

Fetch https://mattwood.fyi/feed.json for the full structured feed, or query the API for keyword/semantic search and the connection graph. See https://mattwood.fyi/agents/ for when-to-use guidance.

Designing APIs for Agents - Freestyle

Connections

Supports

How AgentCore Gateway Supports the MCP 2026-07-28 Spec Freestyle's principle that agent APIs need clarity and predictable behavior is directly embodied in AgentCore Gateway's move to a stateless, HTTP-scalable MCP design.
WebMCP: Making Every Website a Tool for AI Agents The 'clarity above everything' API design principle underlies WebMCP's goal of making website functionality legible and directly callable by AI agents.

Supported by

Serve Markdown to AI Agents with Accept Headers Both address how to design web APIs and content delivery specifically for AI agent consumption; the Accept header approach is a concrete implementation of agent-friendly API design principles
Cedar Policy Authorization and access control via policy languages like Cedar are foundational concerns when designing APIs that must safely serve autonomous agents
How to sync Outlook Gmail calendars using AI MCP Amazon Quick A concrete calendar-sync automation built on MCP illustrates the practical API design tradeoffs discussed abstractly in 'Designing APIs for Agents'.
How Frontier Teams Are Reinventing AI-Native Development Patterns observed from frontier engineering teams reinventing AI-native development directly inform principles for designing agent-facing APIs.
6 RAG Architectures RAG architectures inform how APIs should be designed for agents, particularly around context retrieval and knowledge injection patterns
The New MCP Roadmap The MCP roadmap's HTTP-native transport unification and agentic messaging primitives directly address API design challenges for agent interoperability discussed in Designing APIs for Agents

Develops into

Runway Solaris: Interface World Model OS Designing APIs for Agents explores how interfaces should be structured for agent consumption; Solaris generating interfaces dynamically as a world model represents a potential evolution where interfaces are generated on-demand rather than pre-designed for agents

Type:	link
First published:	Monday, 20 July 2026 at 12:00 UTC
Location:	https://www.freestyle.sh/blog/opinion/designing-apis-for-agents
URL:	https://mattwood.fyi/i/8ba1e900

I'm Matt Wood, and this is For Your Information. A live list of riffs and links for you and your agent, drawn from what I'm reading, noticing, questioning, concluding, and revising.

Connections