Orvelt

What agents can do

Example prompts, every Business MCP tool and the access it needs, how access is limited, and fixes for common connection problems.

Ask in plain language: your agent picks the tools. Name the project, give a time range, and ask for drafts before changes. Anything marked Write needs Write access for that resource when you approve access.

Example prompts

Replies are public: they're posted as your business with an Owner badge.

Tools

Each tool is one Business API operation, with the same input and errors as the REST API. Most take a projectId, so ask your agent to start with projects_list.

Billing

ToolAccessWhat it does
billing_entitlementsReadGet the organization's current plan, feature entitlements, and usage limits.

Projects

ToolAccessWhat it does
projects_listReadList the projects in the organization that the caller can access.
projects_createWriteCreate a project with its own team. The creator is added to the project team.
project_getReadGet one project by ID.
project_updateWriteUpdate a project's name, slug, description, status, visibility, or settings. Archived projects can be restored.
project_uploadWriteUpload an image for a project and return its public URL.
project_deleteWriteDelete a project and its team. The root storefront project cannot be deleted.

Goals

ToolAccessWhat it does
project_goals_listReadList a project's goals.
project_goals_createWriteAdd a goal to a project.
project_goals_updateWriteUpdate a project goal.
project_goals_deleteWriteRemove a goal from a project.

Questions

ToolAccessWhat it does
project_questions_listReadList a project's guided questions.
project_questions_createWriteAdd a guided question to a project.
project_questions_updateWriteEdit, activate, or archive a project question.
project_questions_deleteWriteRemove a question from a project.

Tags

ToolAccessWhat it does
project_tags_getReadGet the tags a project measures, including their display metadata and sentiment metrics.
project_tags_updateWriteChoose which tags a project measures.

Project tag IDs use the lowercase keys trust, reliability, experience, safety, personalization, fairness, identity, and outcome. The update input is an array of { id } objects, such as [{ id: 'trust' }, { id: 'experience' }]; it has no position field. Tag selection is unordered and does not affect question selection or Auto priority. The read response includes each tag's stored name and description, plus metric, metricName, metricRationale, selected, and sentiment metadata.

Delivery

ToolAccessWhat it does
project_link_createWriteCreate a pre-verified opinion link for one customer and optionally email it. Each project can email the same customer once every 48 hours.
project_link_listReadList a project's delivery links and their status.
project_link_resendWriteEmail an existing, unexpired delivery link to its customer again. The 48-hour email cooldown applies.
project_embed_getReadGet the project's embedded opinion form settings, including allowed origins.
project_embed_updateWriteUpdate the project's embedded opinion form settings. An empty origin list allows every website.

QR codes

ToolAccessWhat it does
project_qr_displayReadGet the current link for the project's rotating QR code. Fetch it again when validUntil passes.

Opinions

ToolAccessWhat it does
project_opinions_listReadList a project's opinions with search, reply-status, and date filters.
project_opinions_replyWritePost a public team response to an opinion.

Answers

ToolAccessWhat it does
project_answers_listReadList customers' answers to a project's questions.

Subscribers

ToolAccessWhat it does
project_subscribers_listReadList a project's subscribers.
project_subscribers_countReadCount a project's subscribers.
project_subscribers_inviteWriteEmail invitations to subscribe to a project.

Knowledge base

ToolAccessWhat it does
kb_getReadGet the organization's knowledge base items.
kb_createWriteAdd an item to the organization knowledge base.
kb_updateWriteUpdate an organization knowledge base item.
kb_deleteWriteDelete an organization knowledge base item.

Webhooks

ToolAccessWhat it does
webhooks_portalWriteGet a short-lived link to the hosted webhook portal, where you can manage destinations and retry deliveries.
webhooks_upsertWriteCreate or update a webhook destination URL and the event topics it receives.

File uploads, such as project_upload, take the file as an object with name, mimeType, and base64-encoded base64 content.

Security

Every request is checked on Orvelt's servers against three things, and the agent can only do what all three allow:

  1. What you approved for that agent: None, Read, or Write on each resource.
  2. Your current role and product access in the organization.
  3. Your project team access.

If an owner removes your access, the agent loses it on its next request. Changing billing and managing MCP connections are never available through MCP.

Tool results, such as opinions or subscriber emails, go to the agent and the AI provider behind it. Give None to anything the agent doesn't need, such as subscribers, and connect only agents you trust with customer data. Each person connects their own agent: a connection always acts as the person who approved it.

Disconnect an agent: open Integrations, select Manage on the Business MCP card, and select Disconnect next to the agent. Its access stops immediately.

MCP doesn't use API keys: an MCP connection can't call the Business API, and an API key can't be used with MCP.

OAuth scopes

Read tools need the business:read scope and write tools need business:write; there are no MCP-specific scopes. Connections approved with the older mcp:read / mcp:write scopes must reconnect. MCP and the Business API use separate token audiences and reject each other's tokens.

Troubleshooting