How to Use the Speechnotes MCP in Windsurf

Q: How do I check if my connection to Speechnotes is working?

Run the testspeechnotesauth tool. It gives you an immediate pass/fail on your current MCP Server setup, so you know right away if authentication is good to go.

Q: What language codes does Speechnotes support?

You simply call listsupportedlanguages. The tool returns a definitive list of all the language codes that the Speechnotes MCP Server can handle for transcription.

Q: How do I check my usage limits with Speechnotes and Windsurf?

Use getusagestatistics to pull detailed logs on what resources you're consuming. You can also run getremainingcredits to see exactly how many credits you have left for the MCP Server.

Q: Can I delete a transcription job from Speechnotes using Windsurf?

Yep. If you need to kill a running process, use removetranscriptionjob. It's a clean way to delete the record and stop processing immediately.

Q: How do I export the final text from Speechnotes using Windsurf?

The gettranscriptionexport tool handles this. You run it after a job is complete, and it gives you the result in the format your downstream systems need.

Speechnotes for Windsurf: Automatically process audio transcripts and manage job pipelines without manual steps.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect Speechnotes MCP to Windsurf

Create your Vinkius account to connect Speechnotes to Windsurf — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup Speechnotes with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Run Transcriptions from Remote URLs

Need to transcribe a file hosted elsewhere? You just pass the URL, and `transcribe_audio_url` handles the rest. This is perfect for pipelines where your source data lives outside Speechnotes. It’s fast and reliable. The MCP Server manages the job lifecycle from start to finish, so you don't have to worry about local file handling.

Check Job Status and History

You can track what Speechnotes is doing with `get_transcription_status`. This function tells you exactly where a job stands, whether it’s queuing or done. Want to audit past runs? Use `list_transcription_history` to pull up records of every transcription job you've ever run. It keeps your operations visible.

Secure Webhook Management

Set up a webhook and let Speechnotes push results to your system automatically. `list_configured_webhooks` shows all active delivery endpoints. Security is key here: Always use the `generate_webhook_signature` tool. It verifies that incoming payloads actually came from Speechnotes, not some random bad actor.

Setup guide

Set up Speechnotes MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Speechnotes MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Speechnotes payment history." If connected, Cascade will call the Speechnotes tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

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

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Speechnotes. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Speechnotes now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Speechnotes MCP in Windsurf

Run the `test_speechnotes_auth` tool. It gives you an immediate pass/fail on your current MCP Server setup, so you know right away if authentication is good to go.

You simply call `list_supported_languages`. The tool returns a definitive list of all the language codes that the Speechnotes MCP Server can handle for transcription.

Use `get_usage_statistics` to pull detailed logs on what resources you're consuming. You can also run `get_remaining_credits` to see exactly how many credits you have left for the MCP Server.

Yep. If you need to kill a running process, use `remove_transcription_job`. It's a clean way to delete the record and stop processing immediately.

The `get_transcription_export` tool handles this. You run it after a job is complete, and it gives you the result in the format your downstream systems need.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript