| name | formae-resources |
| description | Use when the user asks about deployed infrastructure, what resources exist, resource counts, or wants to find specific resources by type, stack, label, or management status |
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_stats first to get resource counts by provider
- For specific questions: translate to a Bluge query with at least one filter
- Call
list_resources with 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
