amazon-polly

name	amazon-polly
version	1.0.0
description	Neural text-to-speech via Amazon Polly — high-quality voices, MP3 output, voice listing, default Joanna (en-US Neural).
author	Wunderland
namespace	wunderland
category	voice
tags	["voice","tts","text-to-speech","amazon","aws","polly","neural"]
requires_secrets	["aws.accessKeyId","aws.secretAccessKey"]
requires_tools	[]
metadata	{"agentos":{"emoji":"🔊","primaryEnv":"AWS_ACCESS_KEY_ID","homepage":"https://docs.aws.amazon.com/polly/"}}

Amazon Polly TTS

Use this skill when the agent is deployed on AWS infrastructure or when the user prefers Amazon Polly's Neural engine voices. Polly provides high-quality neural TTS with MP3 output and a wide range of voices across languages and regions.

Prefer this over OpenAI or ElevenLabs TTS when the user already has AWS credentials configured, or when cost efficiency at high volume is a priority (Polly pricing is per-character rather than per-request).

Setup

Set the following in the environment or agent secrets store:

Variable	Description
AWS_ACCESS_KEY_ID	IAM access key ID
AWS_SECRET_ACCESS_KEY	IAM secret access key
AWS_REGION	AWS region (default us-east-1)

Configuration

{
  "voice": {
    "tts": "amazon-polly"
  }
}

With a specific voice:

{
  "voice": {
    "tts": "amazon-polly",
    "providerOptions": {
      "voice": "Matthew"
    }
  }
}

Provider Rules

• Default voice is Joanna (en-US, Neural engine).
• Always use the Neural engine for production — Standard voices are lower quality.
• Call listAvailableVoices() to enumerate all voices available in the configured region.
• Audio is returned as MP3. Playback requires an MP3-capable audio pipeline.

Examples

• "Use Amazon Polly with the Matthew voice for this agent."
• "List available Polly voices in us-east-1."
• "Synthesize this message using Amazon Polly."

Constraints

• Requires AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY with polly:SynthesizeSpeech and polly:DescribeVoices IAM permissions.
• Neural engine voices are region-specific. Not all voices are available in every AWS region.
• API costs apply per character synthesized (Neural engine pricing).