Windsurf, now called Devin Desktop, is a local code editor, so SMS goes through your own server code. Get a Telmian sandbox key, keep it in a gitignored .env as TELMIAN_API_KEY, and ask the agent for a server route that calls POST /v1/verify and /v1/verify/check. Telmian sends from its own European numbers.
Get a free sandbox key
In your project folder, sign in to Telmian and run init. It writes a sandbox key (sk_test_) to .env, so no card is needed. Check that .env is listed in .gitignore.
npx telmian@1 login npx telmian@1 initTell the agent the rules
Devin Desktop reads rules from AGENTS.md or from a file in .devin/rules/ with trigger: always_on. Add a short rule so the agent keeps the key on the server.
Call Telmian only from server-side code (API route or server function). Read the key from process.env.TELMIAN_API_KEY. Never send it to the browser or prefix it with NEXT_PUBLIC_ or VITE_. Use REST https://app.telmian.com/v1 with Authorization: Bearer, or the npm package telmian. While developing, use the sandbox numbers +393000000001 and +393000000002.Optional: add the Telmian MCP server
This only helps the agent while you build; your app does not need it. Add it in Agents window, Customize, MCPs, or in .devin/mcp_config.json as below. Sign in to Telmian in the browser when asked, then approve the Telmian tools when the agent asks.
{ "mcpServers": { "telmian": { "url": "https://app.telmian.com/mcp", "transport": "http" } } }Create the route that sends the code
Ask the agent for a server route in your framework, for example a Next.js route handler or an Express endpoint. Telmian creates the code and sends it. Use one Idempotency-Key per signup attempt and reuse it only when you retry.
const TELMIAN_API_KEY = process.env.TELMIAN_API_KEY; // signupAttemptId: one id per signup attempt, reused if you retry const res = await fetch('https://app.telmian.com/v1/verify', { method: 'POST', headers: { Authorization: `Bearer ${TELMIAN_API_KEY}`, 'Content-Type': 'application/json', 'Idempotency-Key': signupAttemptId }, body: JSON.stringify({ phone }) });Create the route that checks the code
A second server route sends the phone and the code the user typed. Telmian answers with valid true or false.
const check = await fetch('https://app.telmian.com/v1/verify/check', { method: 'POST', headers: { Authorization: `Bearer ${TELMIAN_API_KEY}`, 'Content-Type': 'application/json' }, body: JSON.stringify({ phone, code }) }); const { valid } = await check.json();Test in the sandbox
Run the app locally and open it in the preview. In the sandbox, SMS are simulated: +393000000001 always gets code 000000 and +393000000002 always fails, so you can test both paths.
Go live on your own host
Devin Desktop no longer has a one-click deploy, so deploy to your own host and set TELMIAN_API_KEY there to an sk_live_ key from https://app.telmian.com. Set an approved business name and top up from €5 to start real sends.
Questions
Is Windsurf the same as Devin Desktop?
Yes. Windsurf was renamed Devin Desktop on June 2, 2026. It is the same editor. The default agent is now Devin Local, and Cascade is the legacy agent.
Can the Devin Desktop agent read my API key in .env?
By default Devin Local can read files that .gitignore matches, including .env. You can turn this off with the Gitignore access toggle in Devin Local settings; it applies to new sessions. A .devinignore file does not block agent reads.
Do I put my Telmian API key in the MCP config?
No. The Telmian MCP server uses browser sign-in, so it needs no key. Also, .devin/mcp_config.json is shared through version control, so never put secrets in it.
Can I deploy my app from Windsurf with one click?
No. The Netlify Deploys feature was removed in September 2026. Deploy to your own host and add TELMIAN_API_KEY to its environment variables.
Do I need my own phone or SIM to send SMS?
No. Telmian sends from its own European mobile numbers. It costs €0.05 per SMS segment to mobile numbers in 44 European countries, plus VAT, prepaid from €5 with no monthly fee.
Updated