Ring Appstore MCP Server | Ring Developer Experience Documentation Alexa Amazon Appstore Ring AWS Documentation Console as Settings Sign out Notifications Alexa Amazon Appstore Ring AWS Documentation Support Contact Us My Cases Console Support Contact Us My Cases as Settings Sign out Ring DocsRing Toggle navigation Toggle navigation Ring Developer Documentation Collapse All | Expand All Release Notes App Store Process Getting Started Configure Develop Certify Publish Ring MCP UX Design Guide Ring API Overview Key Features API Standards Getting Started Steps Quick Links API Reference API Reference Details Base URL Authentication (Bearer token) Rate Limiting Content Types Authentication Endpoints Endpoint Reference Webhook Events Error Responses Testing Your Integration SDKs and Libraries Application Deployment Deployment Steps Prerequisites and Setup App Deployment Journey Service Architecture Overview Endpoint Configuration Token Exchange Flow Account Linking Flow (One-way Account Linking) App Integration UX Flow Accessing Devices Webhook Event Delivery Environment Configuration Authentication Account Linking Methods One-Way (Ring-Driven) Partner-Initiated OAuth 2.0 Refresh Tokens Access Tokens Users API App Integration Device Discovery Device Details Capabilities Status Locations Configurations Notifications Notifications Overview Webhook Endpoint Requirements Webhook Authentication & Verification Webhook v1.1 Payload Structure Event Types Webhook Response Handling Retry Logic Common Mistakes Motion Detection Button Press Device Addition Device Removal Device Online Device Offline App Integration Added App Integration Removed Subscription Activated Subscription Deactivated Event History Event History Live Video, Media Clips and Image Snapshots Live Video WHEP Live Video Streaming RTSP Live Video Streaming Media Clips Image Snapshots Subscriptions Query API Ring API Use Cases Error Handling Related topics Customer Lifecycle Analytics Legal Content Ring Appstore Schedule Program Requirements Content Policy Developer Documentation Ring Developer Experience Ring Appstore MCP Server Ring Appstore MCP Server The Ring Appstore Knowledge MCP Server connects your AI coding assistant (Kiro, Cursor, Cline, etc.) to Ring Appstore documentation. Instead of searching through docs on Developer Portal, your AI can instantly access Ring API documentation and answer your integration questions in real-time. What is Ring Appstore MCP? Ring Appstore MCP is a remote Model Context Protocol server backed by an Amazon Bedrock Knowledge Base. When your AI assistant receives a Ring Appstore-related question, it calls the MCP server's tools to search indexed documentation, retrieve full documents, and return accurate answers with source references — all without you leaving your IDE. The knowledge base includes Ring Appstore API references, integration guides, and technical specifications, so you can use it not just to look things up but to actively build apps against Ring Appstore APIs with your AI assistant generating working code from real documentation. Simple Example: You ask: "How do I stream live video from a Ring camera?" Your AI calls search_docs → gets ranked documentation snippets with confidence scores If it needs more detail, it calls get_doc on a specific source → gets the full document You receive accurate API endpoints, authentication steps, and code examples — with sources How It Works You ask a Ring Appstore-related question in your IDE Your AI assistant calls search_docs with your query The server searches the Bedrock Knowledge Base, reranks results, and returns the top matches with confidence scores If the AI needs the full content of a specific document, it calls get_doc with the source URI Your AI synthesizes everything into a complete answer with references Available Tools The Ring Appstore MCP server exposes two tools that your AI assistant calls automatically: search_docs — Search Ring Appstore Documentation Searches the Ring Appstore knowledge base and returns ranked results filtered by confidence. Parameter Type Default Description query string (required) The search query (e.g., "How do I authenticate with AVA APIs?") max_results string "5" Maximum number of results to return min_confidence string "0.2" Minimum confidence score threshold (0.0 to 1.0) Returns a structured result with: status — "success", "clarification_needed", or "error" confidence — Overall confidence score across results results[] — Each containing content, score, and metadata.source (file path or URL) followUpQuestions[] — Suggested follow-ups when results are unclear get_doc — Retrieve Full Document Content Fetches the complete content of a specific documentation file or web page. Typically used after search_docs to get the full text of a result. Parameter Type Description uri string A file path from search_docs results (e.g., "api/authentication.md") or a Ring documentation URL Returns the full document content as a string. Note: You don't need to call these tools manually — your AI assistant invokes them automatically when you ask Ring Appstore-related questions. Understanding them helps you craft better prompts and interpret how your AI arrives at its answers. Quick Setup Prerequisites One of these IDEs installed: Kiro, Cursor, Cline, or Claude Desktop Server URL: https://knowledge.appstore-mcp.ring.amazon.dev/mcp Known Issues Note: Kiro CLI Authorization Issue: The Kiro CLI (not IDE) cannot authorize with Ring Appstore MCP due to a known issue where the CLI fails to construct the correct authorization URL for select MCPs. Workaround: Use Kiro IDE for Ring Appstore MCP integration until the CLI authorization issue is resolved. Configuration Instructions Choose your IDE and follow the steps: Option 1: Kiro IDE (Recommended) Open Kiro IDE Click the Kiro button on the left panel Scroll to MCP Servers section → Click edit icon Add this configuration: { "ring-appstore-knowledge-mcp-server": { "type": "streamable-http", "url": "https://knowledge.appstore-mcp.ring.amazon.dev/mcp", "disabled": false } } Look for a green checkmark (✓) next to "ring-appstore-knowledge-mcp-server" Test it: Ask Kiro "What APIs are provided by Ring Appstore?" Option 2: Cursor Open Cursor Open Settings (Cmd/Ctrl + ,) → Features → Model Context Protocol → Edit Config Add this configuration: { "mcpServers": { "ring-appstore-knowledge-mcp-server": { "type": "streamable-http", "url": "https://knowledge.appstore-mcp.ring.amazon.dev/mcp", "disabled": false } } } Restart Cursor Test it: Open Cursor Chat (Cmd/Ctrl + L) and ask "How do I authenticate with AVA APIs?" Option 3: Cline (VS Code) Install Cline extension in VS Code Click Cline icon → MCP Servers → Remote Servers → Add Remote Server Fill in: Server Name: ring-appstore-knowledge-mcp-server Server URL: https://knowledge.appstore-mcp.ring.amazon.dev/mcp Transport Type: Streamable HTTP Click Add Server Test it: Ask Cline "How do I get motion detection events?" Option 4: Claude Desktop Find your config file: Mac: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json Add this configuration: { "mcpServers": { "ring-appstore-knowledge-mcp-server": { "type": "streamable-http", "url": "https://knowledge.appstore-mcp.ring.amazon.dev/mcp" } } } Restart Claude Desktop Test it: Ask "What Ring devices can I access via API?" Try These Examples Once configured, try asking your AI assistant these questions: Authentication "How do I authenticate with Ring AVA APIs?" Video Streaming "Show me how to stream live video from a Ring camera" "How do I set up WebRTC/WHEP streaming?" Events & Webhooks "How do I receive motion detection notifications?" "What webhook events can I subscribe to?" Device Management "How do I get a list of Ring devices a customer has?" "How do I check if a Ring camera is online?" Code Generation "Generate Python code to authenticate with Ring AVA APIs" "Write Node.js code to handle Ring motion detection webhooks" Note: Multiple MCPs? If your IDE has several MCPs and runs into responses from a wrong MCP, you can prompt the IDE to use the correct MCP name. Examples: • Kiro: 'Use the ring-appstore-knowledge-mcp-server to answer: What APIs are provided by Ring Appstore?' • Cursor: '@ring-appstore-knowledge-mcp-server What are the authentication requirements?' • Cline: 'Query the ring-appstore-knowledge-mcp-server: How do I set up webhook events?' Build a Complete Sample App Ring Appstore MCP can help you build entire applications. Try this advanced example: API Credentials Required: To build and test the sample app below, you'll need API credentials and an access token. These must be requested separately through the Ring Developer Early Access Program. Visit https://developer.amazon.com/ring and apply for Developer Early Access. Example: Person Detection App Use this prompt to build a complete React web app that streams Ring video and detects people in real-time: Step 1: Initial Setup Build a minimal React web app (use Vite React template with bun) for calling Ring Appstore APIs. Set it up for local development with a separate config.js file where you can manually paste credentials. Install the necessary dependencies but skip any documentation files. Add a local proxy server to make the app work on localhost. Use the Ring Appstore MCP server to get Ring Appstore API details. Step 2: Configure Access Token [Manual] Paste your access_token into the config file (token value should be obtained separately). Step 3: Add Live Streaming When you click on a device, start a live streaming session and display the video (canvas or video element). Add play/stop controls. Refer to Ring Appstore API docs for implementation details. Step 4: Add Person Detection Build a real-time person detection app with live counting and historical graph visualization. Stream video from Amazon Vision APIs into TensorFlow "@tensorflow-models/coco-ssd" for person detection. Display current person count and plot historical data using Recharts. No persistence needed. Include logging throughout. What Ring Appstore MCP Will Do: Search Ring documentation for authentication, device discovery, and video streaming APIs Provide code examples for WebRTC/WHEP streaming setup Guide you through OAuth token management Help troubleshoot API integration issues Expected Outcome A working React app that: Lists Ring devices linked to a customer account Streams live video from selected cameras Detects and counts people in real-time using TensorFlow Displays historical person count graphs Troubleshooting Connection Failed? Check the server URL is exactly: https://knowledge.appstore-mcp.ring.amazon.dev/mcp Restart your IDE after configuration changes Ring Appstore MCP Not Being Invoked? Make sure your question is Ring-specific (e.g., "Ring AVA API authentication" not just "authentication") Check that "disabled": false in your configuration Related topics Ring API Development Guide — Development lifecycle, testing process, and code snippets Ring API Documentation — Complete API reference and integration guide Getting Started with Ring Developer Experience — Registration, lifecycle overview, and key terminology What is Ring Appstore MCP? How It Works Available Tools search_docs — Search Ring Appstore Documentation get_doc — Retrieve Full Document Content Quick Setup Prerequisites Known Issues Configuration Instructions Option 1: Kiro IDE (Recommended) Option 2: Cursor Option 3: Cline (VS Code) Option 4: Claude Desktop Try These Examples Authentication Video Streaming Events & Webhooks Device Management Code Generation Build a Complete Sample App Example: Person Detection App What Ring Appstore MCP Will Do: Expected Outcome Troubleshooting Connection Failed? Ring Appstore MCP Not Being Invoked? Related topics