MCP Tools Reference

This document provides detailed information about each MCP tool available through the Atlantis MCP Server.

list_tools
list_categories
list_templates
get_template
get_template_chunk
list_template_versions
check_template_updates
list_starters
get_starter_info
search_documentation
validate_naming

list_tools

Retrieve the complete catalog of MCP tools supported by this server, including each tool’s name, description, and input schema. Use this as the first call in a session to discover available capabilities. Returns an empty array if no tools are configured on the server.

Input Parameters

None.

Example Usage

Ask your AI: "What tools does the Atlantis MCP server provide?"

Use Cases

Discover all available tools at the start of a session
Review tool input schemas for parameter details

List all available template categories with their descriptions and template counts. Takes no parameters. Returns an empty array if no categories are configured. Use this to discover which categories are available before calling list_templates or get_template.

Input Parameters

None.

Example Usage

Ask your AI: "What template categories are available?"

Use Cases

Discover how templates are organized
Understand available infrastructure types before browsing templates

list_templates

List all CloudFormation templates available for deployment via Atlantis scripts, filtered by category, version, or S3 bucket. Categories include: storage, network, pipeline, service-role, and modules. Returns template metadata such as name, version, category, description, namespace, and S3 location. Returns an empty array if no templates match the specified filters. Use the category parameter to narrow results when you know the resource type you need.

Input Parameters

Parameter	Type	Required	Description
`category`	string	No	Filter by template category (storage, network, pipeline, service-role, modules)
`version`	string	No	Filter by Human_Readable_Version (e.g., “v1.2.3/2024-01-15”)
`versionId`	string	No	Filter by S3 version ID
`s3Buckets`	array[string]	No	Filter to specific S3 buckets from configured list

Note: 63klabs is the only bucket and atlantis is the only namespace available via the public Atlantis MCP server. If your organization hosts its own Atlantis MCP server there may be additional namespaces and S3 buckets available.

Example Usage

List all templates:

Ask your AI: "Show me all available CloudFormation templates"

Filter by category:

Ask your AI: "Show me storage templates"

Filter by version:

Ask your AI: "Show me templates version v2.0.18"

Use Cases

Discover available templates for your infrastructure needs
Browse templates by category (pipeline, storage, network, etc.)
Find specific template versions

get_template

Retrieve a specific CloudFormation template with its full content, parameters, outputs, version information, and S3 location. Requires both templateName and category parameters. Returns an error if either required parameter is missing or if the template is not found in the specified category. Optionally pass version or versionId to fetch a specific version rather than the latest.

If the template is too large to return in a single response, a summary is returned instead with contentTruncated: true and totalChunks indicating how many chunks the content was split into. Use get_template_chunk to retrieve the full content incrementally.

Input Parameters

Parameter	Type	Required	Description
`templateName`	string	Yes	Name of the template to retrieve
`category`	string	Yes	Template category (storage, network, pipeline, service-role, modules)
`version`	string	No	Human_Readable_Version (e.g., “v1.2.3/2024-01-15”)
`versionId`	string	No	S3 version ID for a specific version
`s3Buckets`	array[string]	No	Filter to specific S3 buckets from configured list

Note: If both version and versionId are provided, they are treated as an OR condition (returns template matching either).

Note: 63klabs is the only bucket and atlantis is the only namespace available via the public Atlantis MCP server. If your organization hosts its own Atlantis MCP server there may be additional namespaces and S3 buckets available.

Example Usage

Get latest version:

Ask your AI: "Get the pipeline template"

Get specific version:

Ask your AI: "Get template-pipeline.yml version v2.0.18"

Use Cases

Review template content before deployment
Compare template versions
Extract parameter definitions
Understand template outputs

get_template_chunk

Retrieve a specific chunk of a large CloudFormation template that was too large to return in a single get_template response. Requires templateName, category, and chunkIndex (zero-based integer) parameters. Returns an error if any required parameter is missing, if the template is not found, or if chunkIndex is out of range. The response includes chunkIndex, totalChunks, templateName, category, and the chunk content as a text string. Optionally pass version, versionId, s3Buckets, or namespace to target a specific template version. Use this tool after receiving a truncated get_template response to retrieve the full content incrementally.

Input Parameters

Parameter	Type	Required	Description
`templateName`	string	Yes	Name of the template to retrieve
`category`	string	Yes	Template category (storage, network, pipeline, service-role, modules)
`chunkIndex`	integer	Yes	Zero-based index of the chunk to retrieve
`version`	string	No	Human_Readable_Version (e.g., “v1.2.3/2024-01-15”)
`versionId`	string	No	S3 version ID for a specific version
`s3Buckets`	array[string]	No	Filter to specific S3 buckets from configured list
`namespace`	string	No	Filter to a specific namespace (S3 root prefix)

Example Usage

Ask your AI: "The pipeline template was truncated. Get chunk 0 of template-pipeline.yml from the pipeline category"

Use Cases

Retrieve full content of large templates that exceeded the single-response size limit
Incrementally fetch template content chunk by chunk

list_template_versions

List all available versions of a specific CloudFormation template, returning version history with Human_Readable_Version, S3_VersionId, last modified date, and size. Requires both templateName and category parameters. Returns an error if either required parameter is missing or if the template does not exist. Use this to compare versions before upgrading or to find a specific historical version.

Input Parameters

Parameter	Type	Required	Description
`templateName`	string	Yes	Name of the template
`category`	string	Yes	Template category (storage, network, pipeline, service-role, modules)
`s3Buckets`	array[string]	No	Filter to specific S3 buckets from configured list

Note: 63klabs is the only bucket and atlantis is the only namespace available via the public Atlantis MCP server. If your organization hosts its own Atlantis MCP server there may be additional namespaces and S3 buckets available.

Example Usage

Ask your AI: "Show me all versions of the pipeline template"

Use Cases

Track template evolution over time
Find specific versions for rollback
Compare version metadata
Audit template changes

check_template_updates

Check whether newer versions are available for a CloudFormation template and return update information including version, release date, changelog, and migration guide links for breaking changes. Requires templateName, category, and currentVersion parameters. Returns an error if any required parameter is missing or if the template is not found. Pass the currentVersion as a Human_Readable_Version string (e.g., v1.2.3/2024-01-15), Short_Version (e.g., v1.2.3), or S3_VersionId to compare against the latest available version.

Input Parameters

Parameter	Type	Required	Description
`templateName`	string	Yes	Name of the template to check
`category`	string	Yes	Template category (storage, network, pipeline, service-role, modules)
`currentVersion`	string	Yes	Current version you’re using (e.g., “v1.2.3/2024-01-15”)
`s3Buckets`	array[string]	No	Filter to specific S3 buckets from configured list

Note: 63klabs is the only bucket and atlantis is the only namespace available via the public Atlantis MCP server. If your organization hosts its own Atlantis MCP server there may be additional namespaces and S3 buckets available.

Example Usage

Check single template:

Ask your AI: "Check if template-pipeline.yml v2.0.17 has updates"

Check multiple templates:

Ask your AI: "Check for updates on all my templates"

Use Cases

Stay current with template improvements
Plan template upgrades
Identify breaking changes before upgrading
Review changelogs and migration guides

list_starters

List all available application starter code repositories with metadata including name, description, languages, frameworks, features, and S3 location. Starters provide CloudFormation templates, build specs, and Lambda function code for bootstrapping new projects. Returns an empty array if no starters match the specified filters. Optionally filter by s3Buckets or namespace.

Input Parameters

Parameter	Type	Required	Description
`s3Buckets`	array[string]	No	Filter to specific S3 buckets from configured list
`namespace`	string	No	Filter to a specific namespace (S3 root prefix)

Note: 63klabs is the only bucket and atlantis is the only namespace available via the public Atlantis MCP server. If your organization hosts its own Atlantis MCP server there may be additional namespaces and S3 buckets available.

Example Usage

List all starters:

Ask your AI: "Show me available application starters"

Use Cases

Find starter code for new projects
Discover pre-configured application templates
Identify starters with specific integrations
Bootstrap new serverless applications

get_starter_info

Retrieve detailed information about a specific starter code repository, including languages, frameworks, features, prerequisites, and S3 location. Requires the starterName parameter. Returns an error if starterName is missing or if no starter matches the given name. Use this after list_starters to get full details on a specific starter before initializing a project.

Input Parameters

Parameter	Type	Required	Description
`starterName`	string	Yes	Name of the starter repository
`s3Buckets`	array[string]	No	Filter to specific S3 buckets from configured list
`namespace`	string	No	Filter to a specific namespace (S3 root prefix)

Note: 63klabs is the only bucket and atlantis is the only namespace available via the public Atlantis MCP server. If your organization hosts its own Atlantis MCP server there may be additional namespaces and S3 buckets available.

Example Usage

Ask your AI: "Tell me about the atlantis-starter-02 repository"

Use Cases

Understand starter capabilities before using
Review prerequisites and setup requirements
Access example code snippets
Check latest release information

search_documentation

Search Atlantis documentation, tutorials, and code patterns by keyword. Returns results with title, excerpt, file path, GitHub URL, and result type. Requires the query parameter. Returns an empty array if no documents match the query. Optionally filter by type (guide, tutorial, reference, troubleshooting, template pattern, code example) or ghusers to narrow results to specific GitHub organizations.

Input Parameters

Parameter	Type	Required	Description
`query`	string	Yes	Search keywords
`type`	string	No	Filter by type: “guide”, “tutorial”, “reference”, “troubleshooting”, “template pattern”, “code example”
`ghusers`	array[string]	No	Filter to specific GitHub users/orgs from configured list

Example Usage

General search:

Ask your AI: "Search documentation for DynamoDB caching"

Filter by type:

Ask your AI: "Find code examples for Lambda functions"

Use Cases

Find implementation guidance
Discover code patterns and examples
Locate troubleshooting information
Learn best practices
Find CloudFormation resource patterns

validate_naming

Validate a resource name against Atlantis naming conventions and return parsed components with any validation errors. Supports S3 bucket patterns (regional with -an suffix, global with AccountId-Region, and simple global), as well as application, DynamoDB, Lambda, CloudFormation, and service-role resource types. The service-role type validates names against the pattern PREFIX-ProjectId-ResourceSuffix where PREFIX must be ALL CAPS (uppercase letters and digits only) and no StageId is present. Unrecognized resource types are validated using the standard application resource pattern (Prefix-ProjectId-StageId-ResourceSuffix). Requires the resourceName parameter. Returns a validation error if the name does not conform to any recognized pattern. When resource names contain hyphenated components, supply known values such as prefix, projectId, or stageId for accurate parsing. Set isShared to true for shared resources that omit StageId, and hasOrgPrefix to true when the S3 bucket includes an organization prefix segment.

Input Parameters

Parameter	Type	Required	Description
`resourceName`	string	Yes	Resource name to validate
`resourceType`	string	No	Type of AWS resource. `s3` and `service-role` have special validation patterns; all other values use standard application resource validation (`Prefix-ProjectId-StageId-ResourceSuffix`).
`isShared`	boolean	No	When true, validates as a shared resource without a StageId component (e.g., `Prefix-ProjectId-ResourceSuffix`)
`hasOrgPrefix`	boolean	No	When true, indicates the S3 bucket name includes an organization prefix segment
`prefix`	string	No	Known Prefix value for disambiguation of hyphenated components
`projectId`	string	No	Known ProjectId value for disambiguation of hyphenated components
`stageId`	string	No	Known StageId value for disambiguation of hyphenated components
`orgPrefix`	string	No	Known OrgPrefix value for disambiguation of hyphenated components

Example Usage

Validate application resource:

Ask your AI: "Validate this name: acme-person-api-test-GetPersonFunction"

Validate S3 bucket:

Ask your AI: "Is this S3 bucket name valid: acme-myapp-test-123456789012-us-east-1-an"

Validate with known components:

Ask your AI: "Validate acme-my-app-test-Users with prefix acme and projectId my-app"

Use Cases

Verify resource names before deployment
Ensure naming convention compliance
Parse resource names into their components
Validate S3 bucket names across all three patterns
Check service-role naming with ALL CAPS prefix

Error Responses

All tools return errors in a consistent format:

{
  "error": {
    "code": "TEMPLATE_NOT_FOUND",
    "message": "Template 'invalid-template.yml' not found",
    "details": {
      "availableTemplates": ["template-pipeline.yml", "template-storage.yml"]
    },
    "requestId": "abc-123-def-456"
  }
}

Common error codes: - INVALID_INPUT - Input validation failed - TEMPLATE_NOT_FOUND - Requested template doesn’t exist - STARTER_NOT_FOUND - Requested starter doesn’t exist - RATE_LIMIT_EXCEEDED - Too many requests (HTTP 429) - INTERNAL_ERROR - Server error (HTTP 500)

Rate Limiting

All tools are subject to rate limiting. Limits vary by tier — see the rate limits page for the full breakdown.

Rate limit headers included in all responses
HTTP 429 returned when exceeded

Integration Guides - Set up your AI assistant
Common Use Cases - Practical examples
Troubleshooting - Common issues and solutions

Support

If you need help with a specific use case:

Documentation: Full Docs on GitHub
GitHub Issues: Report Issue

Table of Contents

list_tools

Input Parameters

Example Usage

Use Cases

list_categories

Input Parameters

Example Usage

Use Cases

list_templates

Input Parameters

Example Usage

Use Cases

get_template

Input Parameters

Example Usage

Use Cases

get_template_chunk

Input Parameters

Example Usage

Use Cases

list_template_versions

Input Parameters

Example Usage

Use Cases

check_template_updates

Input Parameters

Example Usage

Use Cases

list_starters

Input Parameters

Example Usage

Use Cases

get_starter_info

Input Parameters

Example Usage

Use Cases

search_documentation

Input Parameters

Example Usage

Use Cases

validate_naming

Input Parameters

Example Usage

Use Cases

Error Responses

Rate Limiting

Related Documentation

Support