Guides
How AI agents can work on refunds over MCP
Lumtry exposes refund and dispute cases to AI agents through a Model Context Protocol server. Agents can read cases with a scoped API key and, where enabled, file proposals such as a decision or dispute evidence. Agents never move money: every proposal waits for a person to approve it in the dashboard, in Slack or by phone.
Last updated
Explained 1
What can an agent do through Lumtry's MCP server?
Read and propose. Read tools list and fetch refund cases and dispute cases. Proposal tools let an agent suggest a decision, attach dispute evidence or suggest cancelling a case. Agents cannot open new cases.
Explained 2
Can an agent issue a refund?
No. Every write is a proposal that a person decides in the dashboard, in Slack or by phone. An agent can never set where money goes, override an amount or mark a manual resolution complete, and those requests are refused outright.
Explained 3
How do agents sign in?
Read access uses a scoped API key. Proposal access uses OAuth 2.1 with PKCE, exact redirect URIs and tokens bound to both the client and the person who delegated access. An agent's scopes never exceed that person's role, and revoking the client stops it on its next request.
Explained 4
How is agent text kept from steering the system?
Anything an agent writes is stored as untrusted data attributed to that agent, and it is never read as an instruction. Every tool call and every rejected sign-in leaves an audit row.
How to
Connect an agent in five steps
Check your plan
Reading cases with an API key works on any plan. Proposal tools need the External Agent Access add-on on Starter or Growth, or the Scale plan, and are turned on for your workspace on request.
Create a key or an agent client
For read access, create an API key with only the scopes the agent needs. For proposals, add the agent under Settings, Agent clients, with its exact redirect URI.
Add Lumtry to the agent's MCP configuration
Point the agent's MCP client at Lumtry's server and sign in with the API key or the OAuth client you created.
Let the agent file proposals
The agent reads a case and files a proposal with its reasoning. Approvers see the proposal attributed to the agent that made it.
Decide and follow up
A person approves or rejects the proposal in the dashboard, in Slack or by phone. The agent can poll the task status, or receive a signed callback on a host you allow.
FAQ
Frequently asked questions
Can I limit how often an agent calls Lumtry?
Yes. Each agent client has its own rate limit, and the lower of the client limit and your plan limit applies.
Can an agent's proposal skip my refund policy?
No. An approved proposal runs through the same workflow as any other decision, with the case pinned to its policy version and re-checked against its live state before anything executes.
Can I see what an agent did?
Yes. Every tool call leaves an audit row naming the agent client, and each proposal shows who approved or rejected it.
Which agents can connect?
Any MCP client that can sign in with an API key, or with OAuth 2.1 and PKCE for proposals. The server does not depend on a particular AI vendor.
Keep reading