Build a Moveo AI agent with a coding agent

In this quickstart, a coding agent such as Claude Code builds a support AI agent for an online store through the Moveo MCP server. You write the prompts, and the coding agent calls the Moveo tools. At the end, the AI agent has a published version that answers questions about returns and hands damaged items over to a human. The whole path takes about 10 minutes.

Before you begin

• A Moveo account, and a Moveo login that can edit AI agents in it. You need the account slug: the short name of the account in the Moveo console URL.
• The region of your account: Europe, United States, or Brazil. Most accounts are in Europe.
• A coding agent with MCP support: Claude Code, Codex, Cursor, or VS Code. The prompts in this page work in all of them. The commands use Claude Code.

Step 1: Connect the Moveo MCP server (about 2 minutes)

1. Add the Moveo MCP server of your region. This example uses the Europe URL:

   claude mcp add --transport http moveo https://mcp.moveo.ai/mcp

   For the United States, use https://mcp.us-central.moveo.ai/mcp. For Brazil, use https://mcp.sa-east.moveo.ai/mcp. For Codex, Cursor, and VS Code, see Moveo MCP server.

2. In Claude Code, run /mcp, select moveo, and sign in with your Moveo login in the browser.

The /mcp list shows moveo as connected.

Step 2: Confirm the account (about 1 minute)

Your login can reach more than one account, so name the account in your first prompt. Replace acme with your account slug.

1. Send this prompt to your coding agent:

   Use the Moveo account acme. Confirm the account, then list its AI agents.

2. Check the account name in the reply. The coding agent calls moveo_whoami and moveo_list_agents, and names the account it acts on.

If the account is wrong or missing, your account is in another region. Connect the server of that region and sign in again.

Step 3: Create the AI agent from a brief (about 2 minutes)

1. Send this prompt:

   In the Moveo account acme, create an English support AI agent named Acme returns.
   Brief: Acme Store sells home goods online. Customers can return any item within 30 days
   of delivery for a full refund. If an item arrived damaged, apologize and hand the
   conversation to a human agent. Never promise a refund for a damaged item. Use a
   friendly tone and short replies. Train it, and wait until it is ready.

2. Wait for the reply. The coding agent calls moveo_create_agent with the guidelines from the brief, then calls moveo_get_agent until the status is available. Training takes a few seconds.

The new AI agent is a draft, version 0. Your customers do not see a draft.

Step 4: Test the draft (about 2 minutes)

1. Send this prompt:

   Send these two test messages to Acme returns, each in a new conversation, and show me the replies:
   1. Can I return a lamp I bought two weeks ago?
   2. My vase arrived broken.

2. Compare the replies with the brief. The coding agent calls moveo_send_test_message. The replies are similar to these:

   Message	Reply
   Can I return a lamp I bought two weeks ago?	Yes, you can return the lamp. At Acme Store, you can return any item within 30 days of delivery for a full refund.
   My vase arrived broken.	I'm sorry to hear your vase arrived broken. I will hand this conversation to a human agent to assist you further.

If a reply does not match the brief, tell the coding agent what to change. It updates the guidelines, waits for training, and tests again.

Step 5: Publish the AI agent (about 1 minute)

1. Send this prompt:

   Publish Acme returns with the description "First version".

2. Approve the publish when the coding agent asks. The coding agent names the account and the AI agent first, because a publish changes what customers see.

3. Wait for the reply. The coding agent calls moveo_publish_agent, and the publish takes about 10 seconds.

Test the result

Send this prompt:

List the versions of Acme returns.

The reply shows version 1 with the status available, and the draft, version 0. Version 1 is the version that a channel serves after you route conversations to the AI agent.

To delete the test AI agent, send "Delete the Acme returns AI agent". The coding agent asks you to confirm, because a delete cannot be undone.

Next steps

• Install the Moveo agent skills, so your coding agent follows the same steps without long prompts. They are in the Moveo plugin for Claude Code and Codex. See Moveo MCP server.
• Give the AI agent a knowledge base to answer from. See Knowledge base overview.
• Write simulations that test whole conversations. See Simulations.
• Route a channel to the AI agent with an environment rule. See Rules.