Skip to content

docs: add Build with AI guide to surface llms.txt and MCP server#647

Open
ClintEastman02 wants to merge 6 commits intostrands-agents:mainfrom
ClintEastman02:feat/surface-llms-txt-and-mcp-server-416
Open

docs: add Build with AI guide to surface llms.txt and MCP server#647
ClintEastman02 wants to merge 6 commits intostrands-agents:mainfrom
ClintEastman02:feat/surface-llms-txt-and-mcp-server-416

Conversation

@ClintEastman02
Copy link

Closes #416

Description

Adds a dedicated "Build with AI" page to the User Guide that surfaces the two main ways AI coding assistants can access Strands Agents documentation:

  1. Strands Agents MCP Server — setup instructions for Kiro, Claude Code, Amazon Q Developer CLI, Cursor, VS Code, and a generic section for other MCP clients
  2. llms.txt files — documents the /llms.txt and /llms-full.txt endpoints and the raw markdown convention for individual pages

Also includes practical tips for AI-assisted Strands development (preferring MCP over llms.txt, starting from examples, reviewing output, using project rules).

The page is added to the sidebar navigation right after the Quickstart section with a "new" badge.

Inspired by Astro's Build with AI guide as suggested in the issue.

Related Issues

Type of Change

  • New content
  • Content update/revision
  • Structure/organization improvement
  • Typo/formatting fix
  • Bug fix
  • Other (please describe):

Checklist

  • I have read the CONTRIBUTING document
  • My changes follow the project's documentation style
  • I have tested the documentation locally using npm run dev
  • Links in the documentation are valid and working

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

- Convert MCP setup sections from headings to Tabs components
- Remove redundant Features bullet list, integrate into paragraph
- Add Strands Agents tab showing MCP server usage within agents
- Add /docs/ prefix and clickable links to raw markdown examples
- Remove old llms.mdx page, inline header into llms.txt generators
@github-actions

This comment was marked as outdated.

github-actions[bot]

This comment was marked as outdated.

github-actions[bot]

This comment was marked as outdated.

@zastrowm
Copy link
Member

Looks like CI failed on an unrelated item; will look at fixing that in a separate PR

@github-actions
Copy link
Contributor

github-actions bot commented Mar 12, 2026

Documentation Preview Ready

Your documentation preview has been successfully deployed!

Preview URL: https://d3ehv1nix5p99z.cloudfront.net/pr-cms-647/docs/user-guide/quickstart/overview/

Updated at: 2026-03-13T15:44:16.707Z

@zastrowm
Copy link
Member

Going to take a look at making some changes to avoid going back and forth some more

@zastrowm zastrowm enabled auto-merge (squash) March 13, 2026 15:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[NEW CONTENT] Surface LLMs.txt and mcp-server better

2 participants