Query Infrastructure Resources
Use the list_resources MCP tool to query the formae agent for infrastructure resources.
Important: Avoid Unbounded Queries
The resources endpoint returns ALL matching resources with full properties. An empty query on a large environment can return hundreds of thousands of characters, overwhelming the context window.
Always narrow the query using at least one filter. If the user asks a broad question like "what resources do we have?", start with get_agent_stats for counts, then drill down.
Workflow
- •For broad questions ("what do we have?"): call
get_agent_statsfirst to get resource counts by provider - •For specific questions: translate to a Bluge query with at least one filter
- •Call
list_resourceswith the narrowed query - •Present results grouped logically (by stack, type, or target as appropriate)
Query Examples
| User asks... | Approach |
|---|---|
| "What resources do we have?" | Use get_agent_stats for overview, then drill down |
| "How many S3 buckets?" | type:AWS::S3::Bucket |
| "What's in production?" | stack:production |
| "Show unmanaged resources" | managed:false |
| "S3 buckets in staging" | type:AWS::S3::Bucket stack:staging |
| "Find my-api resources" | label:my-api |
Read the formae://docs/query-syntax resource for the full query syntax reference.
Presentation
- •Group by stack or type depending on context
- •Show resource type, label, and key properties
- •Highlight management status (managed vs unmanaged)
- •Summarize with counts before showing full details