Amazon Developer

Console

as

Settings
Sign out
Notifications
Alexa
Amazon Appstore
Ring
AWS
Documentation
Support
Contact Us
My Cases

Console

as

Get Started
Design and Develop
Publish
Reference
Support
Skip to main content
Amazon Devices Builder Tools for AI-Powered Development includes a Model Context Protocol (MCP) Server and Agent Skills. These components provide Amazon Devices-specific metadata, tools, and workflows to your AI coding agent, so your agent follows recommended patterns and best practices for project setup, feature integrations, performance analysis, crash debugging, and testing. Amazon Devices Builder Tools provides support for Vega OS, which powers Fire TV. For developers also building on Fire OS, it supports In-App Purchase (IAP) integration and app migration workflows. Amazon Devices Builder Tools includes:
  • Builder Tools MCP Server — A standalone npm package that provides Amazon Devices metadata, tools, and capabilities to compatible AI coding agents.
  • Builder Tools Agent Skills — Lightweight, modular, markdown-based instruction sets that guide your agent through Fire TV development workflows.
  • Steering documents — Context files that ground your AI assistant in Amazon Devices best practices.
Amazon Devices Builder Tools doesn’t collect, transmit, or store any of your confidential information. For details, see Privacy FAQ. Amazon Devices Builder Tools is a standalone npm package and isn’t bundled with the Vega SDK. Install it separately using the steps on this page. For the full list of features, supported agents, manual configuration options, and tool reference, see the Amazon Devices Builder Tools ReadMe.

​
Prerequisites

  • Node.js 18 or later
  • Vega SDK v0.22 or later (required only for Vega OS development workflows)

​
Get started

Run the following set-up command in your terminal (Bash or ZSH shell) to configure Amazon Devices Builder Tools for your AI agent and add Amazon Devices-specific context to your project:
This command installs and configures MCP, Steering, and Skills for your AI agent. It prompts you to select your agent, choose an installation directory, and handle existing context files. On subsequent runs of init-context, the command checks for updates and downloads new capabilities automatically. When the command completes successfully, you see output similar to:

​
Interactive mode (default)

When running in interactive mode, you’re guided through:
  1. Select your AI agent (for example, Cursor, Kiro, or Other/Custom).
  2. Enter y/n to automatically update your agent’s MCP settings file.
  3. Choose the default context document installation path or enter a custom path.
  4. Choose action: merge (add new content to existing file), update (overwrite existing file), or save (write to a new file).

​
Non-interactive mode

Use command-line options to skip prompts and automate the setup process:
Available options:

​
Check agent setup status

After installing the MCP server and context documents, verify your setup using the check-status command:
To check a specific agent:
This command checks:
  • Context document installation status and version
  • MCP configuration status
  • Detection of legacy configurations
Example output:

​
Verify setup

After installation, first run check-status to confirm your configuration is correct (see Check agent setup status). Then confirm your agent can access Amazon Devices Builder Tools. In your AI agent’s chat, enter:
Your agent should respond with a list of available tools including analyze_perfetto_traces, get_app_hot_functions, list_documents, read_asset, read_document, search_documentation, and symbolicate_acr. Then try an Amazon Devices-specific prompt:
If your agent responds with Amazon Devices-specific setup steps (rather than generic React Native instructions), the configuration is working correctly. If you encounter issues, see Troubleshoot Amazon Devices Builder Tools for AI-Powered Development. Once setup is verified, try prompts like “Build and run my app on Virtual Device” or “Help me debug TTFF in my app” to use the full range of Amazon Devices Builder Tools capabilities. See Supported workflows for more examples.

​
Builder Tools Agent Skills

Builder Tools Agent Skills are lightweight, modular, markdown-based (SKILL.md) instruction sets that guide your agent through verified steps for common Fire TV development and debugging workflows. Agent Skills trigger automatically when your prompt matches the skill’s metadata. The following skills are available: These skills work alongside any other skills you use or create. New skills are added based on developer feedback.

​
MCP tools

The Builder Tools MCP server provides the following tools to assist with Vega app development:

​
MCP prompts

Builder Tools MCP provides the following pre-defined prompt templates for common workflows. Execute them using /prompts if your AI agent supports MCP Prompts:

​
Supported workflows

In addition to Agent Skills and MCP Prompts, Amazon Devices Builder Tools support the following workflows. For the full list of supported workflows, see the Amazon Devices Builder Tools ReadMe.

​
Privacy FAQ

No. Amazon Devices Builder Tools doesn’t collect, transmit, or store any of your confidential information, including:
  • Your code samples or app source code.
  • Your queries or prompts to the AI assistant.
  • Your project files or configurations.
  • Any other developer data or intellectual property.
However, documentation search queries issued by your AI agent are sent to Amazon Services to find relevant documentation for the task at hand.All interactions between Amazon Devices Builder Tools and your AI assistant happen locally on your machine. Your code and queries remain private and are processed only by your chosen AI assistant, according to that assistant’s own privacy policies. The only exception is documentation search queries.
Your AI assistant processes your queries and code according to its own privacy policy and terms of service. Amazon Devices Builder Tools provides tools and Amazon Devices-specific context to your assistant. The assistant’s data handling practices are governed by its provider. Review your AI assistant’s privacy policy to understand how it handles your data.
Amazon collects anonymous telemetry data to improve Amazon Devices Builder Tools. This telemetry includes feature usage patterns, error rates, and performance metrics. You can disable telemetry collection in the settings.Important privacy protections:
  • No confidential data is collected: Your queries, code samples, project files, or any other developer-created content are never sent to Amazon.
  • Local processing: The MCP runs entirely on your local machine. The only exception is documentation search queries (see Q1).
  • Anonymous data only: Telemetry data doesn’t include personally identifiable information.
Amazon also offers an optional developer survey to understand the usefulness of Amazon Devices Builder Tools. Participation in this survey is voluntary.

​
Troubleshooting

If you encounter any issues, see Troubleshoot Amazon Devices Builder Tools for AI-Powered Development.
Last modified on May 20, 2026