Sinch Conversations — VS Code Extension

Build, test, and send SMS with Sinch Conversation API - right inside VS Code.

Integrate Sinch's Conversation API directly into your IDE. Send SMS, manage webhooks, and access AI-powered code snippets without switching tools. The fastest way to build and test messaging integrations from VS Code.

Official API docs: https://developers.sinch.com/docs/conversation/

Features

Core Explorer Views

Messages: Easily send new SMS messages and view SMS sent within the last ~2 hours
Senders: Browse and add conversation senders
Webhooks: Manage all registered webhooks
Configuration: Inspect currently active Sinch credentials

Messaging & Senders

Quick SMS sending directly from VS Code
Real-time message history and status tracking
Load and manage available senders for your app
Multi-environment SMS testing support
Send SMS quickly from the Messages view (context menu or title actions)

Webhook Lifecycle Management

Create, edit, delete webhooks
Copy webhook ID or fully resolved callback URL
Trigger simulated events and run test payloads using built‑in HTML templates

Credential & Environment Configuration

Guided command to set Key ID, Secret, Project ID, App ID & Region
Fast switching of App ID / Region for multi‑environment testing

AI / MCP Enablement

Optional generation of AI agent configuration files for compatible IDE assistants (Copilot, Cursor, Windsurf)
MCP server integration (see section below)

Code Snippets & IntelliSense

Generate ready-to-use code snippets for common Sinch Conversations API operations
Auto-completion support for Sinch API methods in TypeScript/JavaScript files
Quick access to API examples via Command Palette or tree view

AI Agent Context

Automatic generation of AI agent context files (AGENTS.md) for enhanced assistant capabilities
Provides AI assistants with domain knowledge about Sinch Conversations API
Improves code suggestions and API guidance in supported IDEs

Developer Experience Extras

Lightweight HTML templates for webhook testing & trigger simulation
Structured command palette integration & contextual menus
Copy-paste ready code examples from the Sinch Conversations tree view

Installation

Install from the VS Code Marketplace (recommended) or manually via a packaged VSIX file.

Usage

1. Open the Sinch Conversations View

Click the activity bar icon ("Sinch Conversations"). You will see views for Senders, Messages, Webhooks, and Configuration.

2. Configure Credentials (First Run)

Open the Command Palette (⇧⌘P / Ctrl+Shift+P) and run: "Sinch Conversations: Configure Sinch API". Provide:

Key ID
Key Secret
Project ID
App ID
Region (us | eu)

Once saved, the extension initializes and begins loading senders, webhooks, and recent messages. If credentials are incomplete you will be prompted to configure them.

3. Explore & Act

Configuration view: verify what is currently set.
Senders view: refresh or add a sender via the title menu/context menu.
Messages view: refresh recent messages or send a new SMS directly.
Webhooks view: create, edit, delete, refresh, copy IDs/URLs, and test triggers.

Contextual actions are exposed through:

View title bar buttons (Refresh, Send, etc.)
Right‑click context menus on items (Edit, Delete, Copy ID, Copy URL, Test Trigger)
Command Palette for any action (search "Sinch Conversations")

4. Switching Apps or Regions

Use the relevant selection commands from the Command Palette to rapidly change App ID or Region. This is useful for staging vs production testing.

5. Webhook Testing

Selecting a webhook test action will open an HTML template in the editor, allowing you to simulate inbound requests or trigger events. Adjust payloads and re‑run as needed.

6. Generate Code Snippets

Generate ready-to-use code snippets for Sinch Conversations API operations:

Open Command Palette (⇧⌘P / Ctrl+Shift+P)
Run: "Sinch Conversations: Generate Snippets"
Select the operation you want (e.g., "Send Message", "Create Webhook", "List Apps")
Choose your programming language (TypeScript, JavaScript, Python, cURL, etc.)
The snippet will be inserted at your cursor position or opened in a new file

7. Copy Code from Tree View

Get instant code examples directly from the Sinch Conversations tree:

Navigate to any view (Senders, Messages, Webhooks)
Right-click on the tree view title bar
Select "Copy Code" or click the copy icon in the title bar
Choose your preferred language and operation
Code is copied to your clipboard - ready to paste!

This is the fastest way to get working code for common operations.

8. AI Agent Context Setup

Enhance your AI assistant's knowledge of Sinch Conversations API:

Automatic Setup:

After configuring credentials, you may be prompted to generate AI agent context
Accept to create AGENTS.md in your workspace with Sinch API knowledge

Manual Setup:

Open Command Palette (⇧⌘P / Ctrl+Shift+P)
Run: "Sinch Conversations: Generate Agent Context"
The AGENTS.md file will be created in your workspace root

What it does:

Provides AI assistants (GitHub Copilot, Cursor, Windsurf) with domain-specific knowledge
Improves code suggestions for Sinch API operations
Helps AI understand authentication, regional endpoints, and best practices
Enhances chat responses with accurate Sinch API guidance

When to use:

Working on Sinch integrations and want better AI code suggestions
Need AI to understand Sinch-specific concepts (apps, channels, contacts, etc.)
Want AI to provide accurate API examples and error handling

Note: The agent context file works alongside MCP integration. Use MCP for direct API access, and agent context for improved code suggestions and guidance.

For a complete list of contribution points and commands, refer to package.json or the VS Code Command Palette.

Tip: Nearly every action surfaces in three places: tree view item context menus, view title menus, and the Command Palette—use whichever is fastest for your workflow.

MCP (Model Context Protocol) Integration

This extension supports MCP integration for AI assistants in VS Code, Cursor, and Windsurf IDEs. The MCP server provides AI assistants with access to Sinch Conversations API functions.

Setup MCP

Configure Sinch credentials first using the Configure Sinch API command
Setup Sinch MCP using the command Sinch Conversations: Setup Sinch MCP

The extension will automatically create the appropriate MCP configuration file for your IDE:

VS Code: .vscode/mcp.json (in your workspace)
Cursor: .cursor/mcp.json (in your workspace)
Windsurf: ~/.codeium/windsurf/mcp_config.json (in your home directory)

IDE-Specific MCP Setup Instructions

VS Code

MCP server will be configured automatically
Activation: Open Copilot Chat and allow the MCP server when prompted
The MCP integration will start working immediately after allowing

Cursor

MCP server starts automatically after configuration
If MCP gets disconnected:
- Go to Cursor Settings → Features → Model Context Protocol
- Enable the "sinch" MCP server
- Or restart Cursor if the server doesn't appear

Windsurf

MCP server requires manual activation after configuration
Activation steps:
1. Open Windsurf Settings
2. Go to Features → Model Context Protocol
3. Click the reload/refresh button next to MCP settings
4. Or reload the full Windsurf window (Cmd/Ctrl + R)
5. Enable the "sinch" MCP server

Available MCP Commands

Sinch Conversations: Setup Sinch MCP - Configures MCP for your current IDE + workspace
Sinch Conversations: Uninstall Sinch MCP - Removes MCP configuration

Troubleshooting MCP

MCP server not appearing in IDE settings?

Ensure you've configured Sinch credentials first
Try reloading/restarting your IDE after adding MCP config
Check that the MCP config file was created in the correct location

MCP shows as "disconnected" in Cursor?

Go to Settings → Features → Model Context Protocol
Toggle the "sinch" server off and on again
Restart Cursor if the issue persists

MCP not working in Windsurf?

Always reload the window or click refresh in MCP settings after configuration
Check that the config file exists at ~/.codeium/windsurf/mcp_config.json

Verify MCP Integration is Working

Once you've set up MCP, you can verify it's working by testing with your AI assistant:

Simple verification:

Ask AI: "What MCP tools are available?" or "List available tools"
The AI should show Sinch Conversations API functions

Test Sinch functionality:

Ask AI: "Can you help me send an SMS using Sinch?"
Ask AI: "Show me all conversation apps"

If the AI responds with Sinch-specific capabilities or mentions Sinch tools, your MCP integration is working correctly. If the AI doesn't recognize Sinch tools, refer to the troubleshooting section above.

Telemetry

This extension collects minimal usage telemetry solely to improve developer experience. It honors VS Code's global telemetry setting: if telemetry is disabled globally, no data is collected.

Development

Built with TypeScript and the VS Code Extension API.

Contributing

Contributions welcome. Please run npm run check (lint + compile) before committing and follow formatting rules (Prettier + ESLint). Open an issue or merge request with clear reproduction or proposal context.

License

See LICENSE.md.

Changelog

Release notes are maintained in CHANGELOG.md.

Sinch Conversations API

Sinch Preview