What Alexa-connected devices are supported by this API?

The Alexa Smart Properties API supports: smart lights (on/off, brightness, color), smart plugs and switches, thermostats (mode and temperature monitoring), temperature sensors, Echo devices and speakers (volume control), security sensors, and other Alexa-connected endpoints. Each device exposes specific features (power, brightness, speaker, thermostat, etc.) that can be queried and controlled.

How do I get an OAuth 2.0 access token for the Alexa API?

Visit the [**Alexa Developer Console**](https://developer.amazon.com/alexa/console/ask) and create a Smart Home Skill. Set up Login with Amazon (LWA) credentials in your Amazon Developer account. Complete the OAuth 2.0 authorization flow to obtain an access token. The token must be refreshed periodically as it expires after a set duration.

Can I control devices in different rooms or properties?

Yes! The API returns all devices across all properties and rooms in your Alexa Smart Properties account. Use `list_alexa_devices` to see all devices with their room assignments, then use each device's unique endpoint ID to control them individually. You can also reassign devices to different rooms using the `update_device_room` action.

What's the difference between deregister and forget a device?

`Deregister` removes the device from your Alexa Smart Properties account but keeps it available for re-discovery. The device itself remains configured. `Forget` completely removes the device from Alexa — it will need to be re-discovered and set up again as if it were a new device. Use deregister for temporary removal and forget for permanent removal.

Alexa Smart Home MCP Server for Windsurf 16 tools — connect in under 2 minutes

Name: Alexa Smart Home
Availability: InStock
Author: Vinkius

docs.windsurf.com/windsurf/mcp

Built by Vinkius GDPR 16 Tools IDE

Windsurf brings agentic AI coding to a purpose-built IDE. Connect Alexa Smart Home through the Vinkius and Cascade will auto-discover every tool — ask questions, generate code, and act on live data without leaving your editor.

Get MCP Server for AI Agents

ASK AI ABOUT THIS MCP SERVER

Open in ChatGPT Open in Claude Open in Perplexity

Vinkius supports streamable HTTP and SSE.

RecommendedModern Approach — Zero Configuration

Vinkius Desktop App

The modern way to manage MCP Servers — no config files, no terminal commands. Install Alexa Smart Home and 2,500+ MCP Servers from a single visual interface.

Download Free Open SourceNo signup required

Classic Setup·json

{
  "mcpServers": {
    "alexa-smart-home": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Fully ManagedVinkius Servers

60%Token savings

High SecurityEnterprise-grade

IAMAccess control

EU AI ActCompliant

DLPData protection

V8 IsolateSandboxed

Ed25519Audit chain

<40msKill switch

Stream every event to Splunk, Datadog, or your own webhook in real-time

* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure

About Alexa Smart Home MCP Server

Connect to Alexa Smart Home devices via the Alexa Smart Properties API and control your smart home from any AI agent. Manage lights, thermostats, speakers, and sensors across your connected endpoints.

Windsurf's Cascade agent chains multiple Alexa Smart Home tool calls autonomously — query data, analyze results, and generate code in a single agentic session. Paste the Vinkius Edge URL, reload, and all 16 tools are immediately available. Real-time tool feedback appears inline, so you see API responses directly in your editor.

What you can do

List Devices — See all your Alexa-connected smart home devices with names, manufacturers, and features
Device Details — Get full device information including serial numbers, connections, and capabilities
Power Control — Turn devices on and off (lights, plugs, switches)
Light Control — Get and set brightness levels, adjust brightness relatively
Speaker Control — Get and set speaker volume on Alexa devices
Thermostat Monitoring — View thermostat state including mode and target temperatures
Temperature Sensors — Read current temperature from connected sensors
Rename Devices — Update friendly names for your devices
Room Management — Assign devices to specific rooms/units
Device Management — Deregister or forget devices from your Alexa account

The Alexa Smart Home MCP Server exposes 16 tools through the Vinkius. Connect it to Windsurf in under two minutes — no API keys to rotate, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.

How to Connect Alexa Smart Home to Windsurf via MCP

Follow these steps to integrate the Alexa Smart Home MCP Server with Windsurf.

Open MCP Settings

Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"

Add the server

Paste the JSON configuration above into mcp_config.json

Save and reload

Windsurf will detect the new server automatically

Start using Alexa Smart Home

Open Cascade and ask: "Using Alexa Smart Home, help me..." — 16 tools available

Why Use Windsurf with the Alexa Smart Home MCP Server

Windsurf provides unique advantages when paired with Alexa Smart Home through the Model Context Protocol.

Windsurf's Cascade agent autonomously chains multiple tool calls in sequence, solving complex multi-step tasks without manual intervention

Purpose-built for agentic workflows — Cascade understands context across your entire codebase and integrates MCP tools natively

JSON-based configuration means zero code changes: paste a URL, reload, and all 16 tools are immediately available

Real-time tool feedback is displayed inline, so you see API responses directly in your editor without switching contexts

Alexa Smart Home + Windsurf Use Cases

Practical scenarios where Windsurf combined with the Alexa Smart Home MCP Server delivers measurable value.

Automated code generation: ask Cascade to fetch data from Alexa Smart Home and generate models, types, or handlers based on real API responses

Live debugging: query Alexa Smart Home tools mid-session to inspect production data while debugging without leaving the editor

Documentation generation: pull schema information from Alexa Smart Home and have Cascade generate comprehensive API docs automatically

Rapid prototyping: combine Alexa Smart Home data with Cascade's code generation to scaffold entire features in minutes

Alexa Smart Home MCP Tools for Windsurf (16)

These 16 tools become available when you connect Alexa Smart Home to Windsurf via MCP:

adjust_brightness

Positive values increase brightness, negative values decrease it. Adjust the brightness of an Alexa-connected light relatively

deregister_alexa_device

This removes the device from your account but does not reset the device itself. Deregister an Alexa-connected device from your account

forget_alexa_device

The device will need to be re-discovered and set up again to be used with Alexa. Remove (forget) an Alexa-connected device from Alexa

get_alexa_device

Use endpoint ID from list_alexa_devices. Get detailed information for a specific Alexa-connected device

get_brightness_state

Use endpoint ID from list_alexa_devices. Get the current brightness level of an Alexa-connected light

get_power_state

Use endpoint ID from list_alexa_devices. Get the current power state of an Alexa-connected device

get_speaker_state

Use endpoint ID from list_alexa_devices. Get the current speaker volume state of an Alexa device

get_temperature_sensor

Use endpoint ID from list_alexa_devices. Get the current temperature reading from an Alexa-connected sensor

get_thermostat_state

Use endpoint ID from list_alexa_devices. Get the current state of an Alexa-connected thermostat

list_alexa_devices

Shows device names, manufacturers, models, features, and display categories. USE WHEN: - User wants to see all their Alexa-connected smart devices - User needs to find endpoint IDs for other commands - User is exploring their smart home setup - User asks "what Alexa devices do I have" PARAMETERS: - max_results (OPTIONAL): Number of results (1-50, default: 10) - next_token (OPTIONAL): Pagination token from previous response EXAMPLES: - "List all my Alexa devices" → call with no params - "Show my smart home devices" → call with no params - "What Alexa devices are connected?" → call with no params List all Alexa-connected smart home devices and endpoints

set_brightness

Use endpoint ID from list_alexa_devices. Set the brightness level of an Alexa-connected light

set_volume

Use endpoint ID from list_alexa_devices. Set the speaker volume of an Alexa device

turn_off_alexa_device

Works for lights, switches, plugs, and other power-controllable devices. Turn off an Alexa-connected device

turn_on_alexa_device

Works for lights, switches, plugs, and other power-controllable devices. Turn on an Alexa-connected device

update_alexa_device_name

Use endpoint ID from list_alexa_devices. Update the friendly name of an Alexa-connected device

update_device_room

Use endpoint ID from list_alexa_devices and unit ID from your Alexa Smart Properties account. Update the room/unit assignment for an Alexa-connected device

Example Prompts for Alexa Smart Home in Windsurf

Ready-to-use prompts you can give your Windsurf agent to start working with Alexa Smart Home immediately.

"List all my Alexa-connected smart home devices."

"Turn on the living room lamp and set brightness to 70%."

"What's the current temperature in the bedroom and what mode is the thermostat in?"

Troubleshooting Alexa Smart Home MCP Server with Windsurf

Common issues when connecting Alexa Smart Home to Windsurf through the Vinkius, and how to resolve them.

Server not connecting

Check Settings → MCP for the server status. Try toggling it off and on.

Alexa Smart Home + Windsurf FAQ

Common questions about integrating Alexa Smart Home MCP Server with Windsurf.

How does Windsurf discover MCP tools?

Windsurf reads the mcp_config.json file on startup and connects to each configured server via Streamable HTTP. Tools are listed in the MCP panel and available to Cascade automatically.

Can Cascade chain multiple MCP tool calls?

Yes. Cascade is an agentic system — it can plan and execute multi-step workflows, calling several tools in sequence to accomplish complex tasks without manual prompting between steps.

Does Windsurf support multiple MCP servers?

Yes. Add as many servers as needed in mcp_config.json. Each server's tools appear in the MCP panel and Cascade can use tools from different servers in a single flow.