How do I install Giggy Speech MCP?

Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Giggy Speech MCP need an API key?

No required environment variable is listed on this record.

What transport does Giggy Speech MCP use?

Giggy Speech MCP is reached over HTTP.

When was Giggy Speech MCP last checked?

Last checked 2026-11-09. Giggy speech tools for AI agents: discover voices and generate text-to-speech.

Giggy Speech MCP server

Power your agent

Add this server

The publisher's own URL. Not a PlugMCP endpoint.

Add to Cursor Add in Claude Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Server URL

https://giggy.ai/mcp

The Claude button above opens Claude with the name and URL filled in. You still confirm it there.

shClaude Code

1claude mcp add --transport http io.github.grqdigitalcapital-giggy-mcp https://giggy.ai/mcp

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.grqdigitalcapital-giggy-mcp": {4      "command": "npx",5      "args": [6        "-y",7        "mcp-remote",8        "https://giggy.ai/mcp"9      ]10    }11  }12}

claude_desktop_config.json

Remote · HTTPPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Remote

Transport: http
Version: 1.0.2
Last checked

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

Giggy MCP — text-to-speech and recorded transcription for AI agents

Giggy MCP is a remote Streamable HTTP Model Context Protocol (MCP) server for using Giggy text-to-speech and recorded-audio speech-to-text from coding agents and AI clients.

It provides Giggy speech tools to Codex, Claude Code, Cursor, VS Code, Cline, Windsurf-compatible clients, and other MCP clients.

MCP registry and plugin directories

Giggy's remote speech MCP endpoint is:

https://giggy.ai/mcp

This repository contains the publication artifacts for:

Official MCP Registry: server.json
OpenAI / Codex: openai-plugin/
Claude Code: .claude-plugin/plugin.json

See directory submission status and requirements.

A public registry listing, plugin submission, and approved plugin publication are separate steps. Consult the submission document for verified status.

Install for AI coding agents

Agent Skill — Codex and Claude Code

npx skills add giggy-ai/giggy-mcp --skill giggy-speech

The skill provides Giggy speech-generation and recorded-transcription instructions. An MCP connection is still required.

Claude Code plugin

claude plugin marketplace add giggy-ai/giggy-mcp
claude plugin install giggy-speech@giggy

Codex

Follow the existing Codex MCP setup below.

Example prompt

"Use Giggy to list available English voices, generate a short Batch speech sample saying 'Hello from Giggy', and return the completed audio URL."

Discover Giggy

Quick setup

Use Giggy MCP with Codex

Set GIGGY_API_KEY in your environment, then add to ~/.codex/config.toml:

[mcp_servers.giggy-speech]
url = "https://giggy.ai/mcp"
bearer_token_env_var = "GIGGY_API_KEY"

Use Giggy MCP with Claude Code

Set GIGGY_API_KEY, then configure:

{
  "mcpServers": {
    "giggy-speech": {
      "type": "http",
      "url": "https://giggy.ai/mcp",
      "headers": { "Authorization": "Bearer ${GIGGY_API_KEY}" }
    }
  }
}

Keep API keys out of configuration files committed to source control.

Remote MCP server

https://giggy.ai/mcp

Transport:

Streamable HTTP

The current Giggy MCP endpoint is stateless and accepts POST requests.

Authentication

Use a Giggy API key:

Authorization: Bearer $GIGGY_API_KEY

Giggy API keys begin with:

giggy_sk_

Keep the key in your MCP client's secret or environment configuration.

Do not:

put it in ordinary prompts
commit it to source control
embed it in browser JavaScript

Speech tools

This repository documents these Giggy speech tools:

list_voices
list_my_voices
generate_speech
get_speech_generation
transcribe_audio

Read the connected server's tool schemas before calling these tools. Recorded transcription is asynchronous admission, followed by durable status/result retrieval. MCP does not transport live microphone frames; use the Python or Node.js SDK for that workflow.

Transcribe recorded audio with a coding assistant

Connect MCP with your own Giggy API key, then ask: "Use Giggy to transcribe my authorised recording with the available recorded-audio tool, retain the generation UUID, and retrieve the completed transcript."

The assistant must inspect transcribe_audio's current schema, prepare the supported input and use one idempotency key per intended operation. Poll get_speech_generation without resubmitting. Retrieve the canonical transcript only after completion; do not treat admission as final text. Check pricing and limits before paid usage. The current transcript contract does not provide speaker diarization, word timestamps, sentiment or PII redaction.

For SDKs, Pipecat, n8n and learning resources, use the developer tool guide.

Recommended speech workflow

Call list_voices or list_my_voices.
Select the exact returned voice_id.
Call generate_speech.
Supply a fresh idempotency_key for each new intended generation.
Save generation.generation_uuid.
Call get_speech_generation while the status is queued or processing.
When the status becomes completed, use generation.result.url.

Do not resubmit a new generation while polling an existing generation.

Use Giggy MCP with Codex

Set:

export GIGGY_API_KEY="giggy_sk_..."

Then add this to:

~/.codex/config.toml

[mcp_servers.giggy-speech]
url = "https://giggy.ai/mcp"
bearer_token_env_var = "GIGGY_API_KEY"

A ready-to-copy version is included at:

examples/codex-config.toml

Verify:

codex mcp list

Use Giggy MCP with Claude Code

Set:

export GIGGY_API_KEY="giggy_sk_..."

A project MCP configuration is included at:

examples/claude-code.mcp.json

Its contents are:

{
  "mcpServers": {
    "giggy-speech": {
      "type": "http",
      "url": "https://giggy.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${GIGGY_API_KEY}"
      }
    }
  }
}

Copy that configuration to:

.mcp.json

in the project where Claude Code should use Giggy.

Then run:

claude mcp list

or use:

/mcp

inside Claude Code.

Other MCP clients

Ready-to-copy client configurations are included for:

Client	Example
Codex	examples/codex-config.toml
Claude Code	examples/claude-code.mcp.json
Cursor	examples/cursor.mcp.json
VS Code	examples/vscode.mcp.json
Cline	examples/cline.mcp.json
Windsurf-compatible clients	examples/windsurf.mcp.json

Cursor

Set:

export GIGGY_API_KEY="giggy_sk_..."

Copy or merge:

examples/cursor.mcp.json

into:

.cursor/mcp.json

for project configuration, or:

~/.cursor/mcp.json

for global configuration.

VS Code

Copy or merge:

examples/vscode.mcp.json

into:

.vscode/mcp.json

VS Code will prompt securely for the Giggy API key.

Cline

Open Cline's MCP server configuration and copy the contents of:

examples/cline.mcp.json

Replace:

YOUR_GIGGY_API_KEY

in your local configuration only.

Do not commit the configured file.

Windsurf-compatible clients

For installations that use:

~/.codeium/windsurf/mcp_config.json

merge the contents of:

examples/windsurf.mcp.json

and replace:

YOUR_GIGGY_API_KEY

in the local configuration only.

Raw MCP examples

Set:

export GIGGY_API_KEY="giggy_sk_..."

Initialize:

./examples/initialize.sh

List tools:

./examples/list-tools.sh

List public voices:

./examples/list-voices.sh

Important behavior

generate_speech returns durable generation metadata.

It does not return live MP3 or PCM audio bytes through MCP.

For progressive PCM audio, use:

POST https://giggy.ai/v1/text-to-speech

with:

mode=streaming
output_format=pcm_24000

Developer resources

Speech API documentation:

https://giggy.ai/docs/speech-api

OpenAPI:

https://giggy.ai/v1/openapi.json

Runnable examples:

https://github.com/giggy-ai/giggy-examples

Pricing:

https://giggy.ai/pricing

Official SDK and runnable examples:

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Giggy Speech MCP?

Does Giggy Speech MCP need an API key?

What transport does Giggy Speech MCP use?

When was Giggy Speech MCP last checked?

Documentation

Giggy MCP — text-to-speech and recorded transcription for AI agents

MCP registry and plugin directories

Install for AI coding agents

Agent Skill — Codex and Claude Code

Claude Code plugin

Codex

Example prompt

Discover Giggy

Quick setup

Use Giggy MCP with Codex

Use Giggy MCP with Claude Code

Remote MCP server

Authentication

Speech tools

Transcribe recorded audio with a coding assistant

Recommended speech workflow

Use Giggy MCP with Codex

Use Giggy MCP with Claude Code

Other MCP clients

Cursor

VS Code

Cline

Windsurf-compatible clients

Raw MCP examples

Important behavior

Developer resources