Tools and permissions

The tools Kentro MCP exposes, how they follow your role and permissions, the built-in prompts and example requests.

Kentro MCP exposes two tools of its own plus Kentro AI's internal tools. Which tools a connection sees, and what they return, follows the permissions of the user who approved it.

Tools

ToolWhat it doesInput
askCopilotHands a question or task to Kentro AI, the full agent with your workspace's data, skills, memories, learnings and instincts. Best for multi-step, ambiguous or judgment-heavy requests. Returns the final answer and a conversation_id.message (required); conversation_id (optional, continues a thread)
getSessionContextReturns who the connection acts as, the workspace, and the tables you can query. Call it at the start of a data-heavy session.None
Kentro AI's toolsThe tools Kentro AI uses itself, exposed directly. Fast and inexpensive for well-defined lookups.Per tool; your client shows each schema

Kentro AI's tools by area. The names are examples; your client lists the current set.

AreaExample tools
Orders and fulfillmentgetOrdersSummary, listOrders, getOrderDetail, getFulfillmentPipeline
Inventory and productsgetInventorySummary, getTopProducts
Data querieslistQueryableTables, describeTable, sampleTable, runSqlQuery
Reports and dashboardslistKiqReports, describeKiqReport, runKiqReport, listDashboards, createDashboard
Knowledge base and tutorialssearchKnowledgeBase, getKbArticle, findKbArticlesByEntity, listAvailableTutorials
Conversations and learningslistMyConversations, recallConversation, saveCopilotLearning
RecommendationsgetRecommendations, actOnFinding
  • Data queries run on a read-only database connection.
  • Messages and scheduled tasks (sending an email or text to people in your workspace, creating a recurring report) go through askCopilot. Called directly, those tools answer that channels are not available, because they need a Kentro AI conversation to attach to.
  • Two tools exist only in the Kentro web app and are not exposed: triggerInteractiveTutorial, which drives an in-app walkthrough, and renderVisualization, which draws a chart in the app.
  • New Kentro AI tools appear in Kentro MCP automatically, and the server tells clients when the list changes.

How permissions apply

  • Every call runs as you. The connection carries the user who clicked Approve, in the workspace they approved it in. Permissions are resolved on every request, so a change to your permission groups applies to the next call.
  • The same access as in Kentro. The workspace must have Kentro AI on, and every tool checks your permissions as it does in the web app. Some tools, such as reports and finance reconciliation, check specific permissions of their own.
  • Help Center only. When a non-admin user's permission groups include copilot:restrict:data, the connection runs in Help Center mode: askCopilot, getSessionContext without the table list, and the knowledge base, tutorial, learning, task and messaging tools. No business data is reachable. Admins are never restricted.
  • One workspace. A connection reads and acts in the workspace it was approved in, and nowhere else.

askCopilot or a direct tool

UseWhen
askCopilotThe request spans several steps or areas, needs Kentro judgment, sends a message or schedules a task, or continues an earlier Kentro AI conversation. Kentro AI runs inside Kentro, the turn uses your workspace's Kentro AI credit like a chat in the web app, and the conversation is saved in your Kentro AI history.
A direct toolA quick, well-defined lookup your AI client can reason about itself, such as one order or today's totals.

To continue a thread, pass the conversation_id from the previous askCopilot answer.

Built-in prompts

PromptArgumentWhat it asks for
daily-ops-digestNoneToday's new orders and revenue against yesterday, the fulfillment pipeline, inventory that needs attention and failed syncs or alerts, ending with the top three recommended actions.
investigate-orderorder_numberOne order end to end: status, items, fulfillment orders and warehouse routing, labels and tracking, payment state and sync with the sales channel.

Example requests

  • "Use getSessionContext, then list the tables I can query."
  • "What were yesterday's top ten products by units sold?"
  • "Show order 1042 with its fulfillment orders, warehouse routing and tracking numbers."
  • "Which inventory items need attention this week?"
  • "Using askCopilot, find orders unfulfilled for more than three days and explain why each one is stuck."
  • "Using askCopilot, create a task that emails me the fulfillment pipeline every Monday at 8:00."

Limits and messages

SituationWhat the tool answers
More than 30 calls a minute or 600 a day for your user, or 120 a minute or 4,000 a day for the workspaceRate limit exceeded. Retry in <n>s.
The workspace has no Kentro AI credit left (askCopilot)This workspace is out of Kentro AI credit. An admin can top up in Billing.
A tool failedTool execution failed. The error has been reported. Kentro keeps the detail in its logs.
A tool your connection may not useUnknown tool: <name>

Related


Did this page help you?