MCP and keys

Connect an AI assistant, such as Claude or Cursor, to your Woise account so it can read and build your agents for you.

Open MCP in the sidebar, under Developer. The page has two parts: the Server address your assistant connects to, and the Keys it signs in with.

Connect an assistant

Create a key

Select Create New Key, give it a Key Name you will recognise later, such as the tool or computer that will use it, and select Create Key.

The key is shown once, in API Key Created Successfully. Copy it and keep it somewhere safe. You cannot see it again, so if you lose it, delete it and create a new one.

Copy the server address

Under Server address, select Copy address. The address ends in /api/v1/mcp/.

Add it to your assistant

In your assistant's MCP settings, add a server with that address and send the key in either header:

X-API-Key: <your key>
Authorization: Bearer <your key>

What the assistant can do

With a key, an assistant works inside your organization only. It can:

List your agents and read how each one is built.
Create an agent, and edit one. Edits are saved as a draft, so your published agent does not change until you select Publish in the app.
Look up the step types and the guide to writing voice prompts.
List runs and read a single run, and list recordings.
List your tools, knowledge base documents and saved credentials. For credentials it sees the name and type, never the secret.

A key also lets your own systems send contacts to an outbound campaign whose source is Webhook. See Campaigns.

The Keys list shows each key's name, its first few characters, when it was created and when it was last used. To remove a key, select its delete button and confirm. A deleted key stops working at once.

A key gives access to your organization. Keep it in a password manager or secret store, never in source code, and delete it if it may have been seen by someone else.

Good habits

Create one key for each tool or person that uses one, so you can remove one without breaking the others.
To replace a key, create the new one first, move the tool onto it, then delete the old one.
Delete a key as soon as nothing uses it.

Common questions

What is Woise?

Woise lets you build AI agents that answer and make phone calls and chat on your website. You lay out the conversation on a visual canvas, try it in your browser, then connect it to a phone number.

Do I need a phone number to start?

No. You can build and test an agent in the browser without one. When you are ready, connect a phone number and choose which agent answers it.

How does billing work?

You pay for the minutes your agents use, from your credit balance. There are no seat fees and no per-agent fees, so an agent that is not taking calls costs nothing.

Which languages can an agent speak?

Agents can listen and speak in more than 40 languages, including English, Spanish, Hindi, Tamil and Arabic. You pick the language and the voice for each agent.

Can an agent connect to my CRM or calendar?

Yes. An agent can look things up and make changes in 26 apps, such as Salesforce, HubSpot, Google Calendar, Slack and WhatsApp, during the call. You connect each app once.

Do I need engineers to build an agent?

No. Everything is built in a visual editor, so you can create and change an agent without writing code. If your team prefers code, there is also a REST API and an MCP server.

What happens to call recordings and transcripts?

Every call keeps a transcript and its outcome, and audio is only recorded if you turn it on. Only people in your account can see your calls, and your account lives in the region you chose when you signed up.

What do I have to set up or run?

None. We run the speech, the language models, the recordings and the phone connections, and scale them with your call volume. There is nothing for you to set up or keep running.

How do I reach the team?

Email contact@woise.ai, call or WhatsApp +91 83412 34080, or use the form on our contact page. A person reads every message.

Still stuck? Talk to our team.