MCP App Store
by KeenEthics
Roiva icon

Roiva MCP Server for ChatGPT

By Roiva

Overview

Roiva is where an organization records what each of its AI initiatives costs and the value it has delivered. This plugin lets ChatGPT read your Roiva account with your permissions and answer from it, with a link to the page in Roiva each figure came from. Ask about: - Your portfolio: which initiatives are live, what each has cost, and its cash ROI, over all time or a period you name. - One initiative: its costs, its approved value, its business case against what it has delivered, the formula behind a figure and the entries behind a month. - Cash value and freed capacity, as two figures. Value counts only approved entries. Freed capacity is hours freed, priced at what they cost; it isn't cash, and it is never added to cash value. ROI, net and payback are cash only. - Your account's assumptions, such as its loaded hourly rate, and how earlier business cases compared with results, so a new estimate starts from your own figures. - Integrations: which connections are healthy, and why one isn't bringing data in. - How Roiva works, from its own help articles and setup guides. Drafts a person accepts. Where your account allows it, ChatGPT can also draft a monthly figure Roiva is waiting for, a vendor bill's charges as an initiative's costs, or an initiative's business-case figures, each with the source it came from. Nothing in Roiva changes until a person accepts the draft in Roiva, and ChatGPT can withdraw its own drafts. It can't approve value, book costs, move an initiative through its stages or delete anything. Those stay in Roiva. You sign in with your Roiva account (with single sign-on where your organization requires it) and choose which account to connect. An Owner or Admin decides who may connect an assistant and who may let one draft. Every lookup is recorded in the account's audit log. Requires a Roiva account.

How to connect

  1. ChatGPT: Open the Roiva listing in the ChatGPT app directory and choose Connect. ChatGPT listing Roiva exposes 26 tools here.

Tools

fetch

ChatGPT
Read in full one document search returned, by its ID (such as initiative:42 or help:7): an initiative's figures, a metric's definition, a connection's health, a template or a help article.

get_assumptions

ChatGPT
The account's assumptions: the figures its formulas price with, such as a loaded hourly labor rate, a cost per deflected ticket or a contribution margin, as the Assumptions page lists them. Each gives the figure in force today with its unit (money is US dollars, unless an account typed a unit naming another currency, which nothing converts), whether it is the account's own or Roiva's unconfirmed default, who set it and when, whether it stands in for a figure nobody has measured, and how many formulas and initiatives read it. Pass input_key for one assumption in full: what it measures, its basis or source, every dated figure by period with who set each and why, and each formula reading it. Use these figures, not rates of your own, when estimating with this account's numbers. A share of an outcome's change credited to one initiative is that initiative's own: get_formula shows it.

get_connection_health

ChatGPT
One integration connection's health: whether it needs to be reconnected, its latest error, and what its last few syncs did (records brought in, skipped and failed, and why). Use it for "why isn't my data coming in" and "did the sync work". Get the ID from list_integrations.

get_cost_breakdown

ChatGPT
The cost entries behind an initiative's total cost, newest first, with the sum computed for you: each entry's period, type, capex or opex, amount in dollars, vendor, source and notes; totals by type and category; and anything counted at a provisional rate or left out for want of one. Pass month (YYYY-MM) for one month.

get_entry_history

ChatGPT
What happened to one value entry, cost entry or reading: who recorded, edited and approved it, who can approve a value entry not counted yet ("you" is the user) or what has to happen first, the approval decisions and reasons, inputs that changed since it was calculated, and, for an Admin or Owner on a plan with the audit log, its audit log rows. Pass the entry's ID from get_value_breakdown or get_cost_breakdown.

get_formula

ChatGPT
The value formulas live on an initiative: each one's expression, the type of value it books, and every input with what it reads today (the latest reading, the baseline with its method and when it was set, or the assumption and who set it) and the figure it last used. Use it for "how is this calculated", "what baseline is it using" and "how do I change the baseline". For a template's formulas before an initiative uses them, use get_template.

get_help_article

ChatGPT
Fetch the full text of a published Roiva help article: how the product works, where things are and who can do them. Pass its slug (the last part of an article's /docs/ URL, or from the help index where you have one) or its ID, as search_roiva and search_help return it. A /docs/reference/ page is generated, not an article, and this can't fetch it.

get_initiative

ChatGPT
Get detailed information about a single initiative: stage, category, owner, expected financials (its business case), its approved budget against spend to date, and recent costs/value entries/notes.

get_metric

ChatGPT
One metric's definition: what it counts, its unit, why a formula asks for it where that isn't obvious, what to watch out for and the help article that goes further. Pass its metric key (such as cloud.usage.unit_count) or the ID search_roiva returns.

get_plan_vs_actual

ChatGPT
How the business cases of initiatives that went live (including any since paused, completed or dismissed) compare with what they delivered: for each, its planned figures (CapEx, OpEx and value per period, freed capacity), the plan to date beside approved actuals to date for cash value, freed capacity and cost, cash ROI actual and planned to date, how long it has been live, time to first value against its target, what its value rests on, and what was left out for want of an exchange rate. Cash value against plan is judged as ROI › Initiatives judges it (behind, on plan, ahead, or why not yet). Cash and freed capacity are separate figures, never added. Use it for "how far off were our earlier business cases" before estimating a new one. Filter by category or template_id (from search_roiva, types: templates).

get_platform_setup_guide

ChatGPT
The guide for connecting one platform to Roiva (Zendesk, HubSpot, AWS, GitHub, QuickBooks…), as the connect form shows it: how it connects, the steps, where to find the credential, any setup script, tips, whether this account has connected it, and the page to connect it from. Use it for any "how do I connect X" question.

get_roi_summary

ChatGPT
Get the actual ROI rollup — cash value and freed capacity (approved entries, two figures never added), cost, net cash, cash ROI %, capex/opex split, with the URL of the ROI page that shows them. Pass initiative_id for a single initiative; omit for the whole portfolio.

get_template

ChatGPT
One initiative template from the library: what it is for, its hypothesis, ratings, the financial defaults it prefills (Roiva's typical figures, not this account's), what it counts as cost, and the value formulas it ships, with the metrics each one reads and why. Use it for "why does this template use X" or "what does it measure". Find the ID with search_roiva (types: templates) or from a template page's URL.

get_value_breakdown

ChatGPT
The value entries behind an initiative's value figure, newest first, with the sum computed for you. Each entry gives its period, type (cash or freed capacity), amount, status, whether it counts, what it rests on, the formula and every input it was calculated from, notes about those inputs, readings that changed since, and who approved it. An entry not counted yet says who can approve it now ("you" is the user), or what has to happen before anyone can; repeat that rather than guessing at the approval rules. Totals are counted as the ROI page counts them, for that month or all periods (not a reporting period), plus what is not counted yet. Use it for "how does this figure tie", "why is this month lower" and "what is in this number". Pass month (YYYY-MM) for one month; omit it for all periods.

list_initiatives

ChatGPT
List AI initiatives for the current account. Returns id, title, stage, and status. Optionally filter by status.

list_integrations

ChatGPT
List the account's integration connections, with platform, status, last sync time, whether one needs to be reconnected, and its latest error. For why one isn't bringing data in, use get_connection_health.

list_my_proposals

ChatGPT
The changes you have drafted for a person to accept in Roiva, newest first: each one's status (waiting, accepted, declined with the reason given, withdrawn, expired or superseded), who decided it, and its page in Roiva.

list_requested_readings

ChatGPT
The monthly figures Roiva is asking a person to type in, because no connected system reports them: for each, the initiative, the metric key and its name, the month it is asked for (YYYY-MM; a month's total is asked once the month has ended), its unit, where to find it, and any proposal already waiting. Use it before propose_reading. For an initiative recorded as live from an earlier date, it also lists the months since then that still take a figure (the initiative's Past months page in Roiva); draft those with propose_past_readings.

propose_costs

ChatGPT
Draft the charges on one vendor bill Roiva doesn't connect to (an invoice, receipt or usage export you can see) as costs on an initiative, for a person to review and book in Roiva. Nothing in Roiva changes until they book it there; the costs they book then count toward ROI at once, so say plainly that it is only a draft. Roiva checks each line against what the initiative already books (its cost connections, vendor mappings, entries and locked months) and says which may count twice or can't be booked. Amounts are in the bill's currency; Roiva books US dollars only. At most 50 lines, and the call must stay under 16 KB, so keep descriptions and quotes short and propose a longer bill in parts (a month at a time), giving each part its own bill_reference ("INV-0042 part 2"): parts with the same one replace each other. Give the source the bill came from. A second call with the same vendor and bill_reference (or, with no bill_reference, the same vendor and lines) replaces your earlier proposal; give the bill_reference every time if the bill has one.

propose_initiative_setup

ChatGPT
Draft a new initiative's whole setup for a person to review and accept once in Roiva: the initiative from a library template (get_template shows what its formulas read), the date it went live where it was already running, its own assumption figures and baselines (each with a basis line naming the count, the rate, the document or system and who supplied it), the figures for each complete month since it went live, and a vendor bill's charges. Nothing in Roiva changes until a person accepts it there: they choose what to keep, recording the go-live approves the initiative and takes one of the plan's measured places, what the figures calculate waits for an approver, and the bill's lines wait to be booked. Say plainly that it is only a draft. Only figures the template's formulas read, and only ones an initiative can hold for itself; an account-wide figure is refused. For an initiative that already exists, use propose_past_readings, propose_plan_figures and propose_costs instead.

propose_past_readings

ChatGPT
Draft the figures for the months an initiative has already been live, for a person to review and accept in Roiva: the months list_requested_readings lists as past months (the initiative's Past months page), for an initiative recorded as live from an earlier date. One call takes every figure and month for the initiative; the month Missing Inputs asks for (the last ended one) goes through propose_reading instead. Nothing in Roiva changes until a person accepts it there; each month whose figures are all in is then calculated (once the figures every month reads are set, which Roiva's reply names when they aren't), and what it calculates waits for an approver, so say plainly that it is only a draft. Give the source each figure came from. Roiva checks each month as the page would (it still takes a figure, isn't locked, the figure is in range) and says what to fix. A second call for the same initiative replaces your earlier proposal.

propose_plan_figures

ChatGPT
Draft an initiative's business case: its planned figures, each with a basis line and the source it came from, for a person to review and save on Edit Business Case in Roiva. Nothing in Roiva changes until they save it there, so say plainly that it is only a draft. Open the help article writing-an-initiatives-business-case first. Write each basis line with the count, the rate, the document or system it came from, and who supplied it. Price hours at the loaded hourly rate the initiative's own formulas read (get_formula, get_assumptions), so the plan and the measured value are priced alike. Not while the initiative is in review (its CapEx and OpEx decide who approves it), nor once it was rejected or dismissed. After approval its budget doesn't move. Roiva says how each figure compares with the one there now. A second call for the same initiative replaces your earlier proposal, so give every figure you mean each time.

propose_reading

ChatGPT
Draft one month's figure for a metric Roiva asks for (list_requested_readings), for a person to review and accept in Roiva. Nothing in Roiva changes until they accept it there, and what it calculates then waits for an approver; say so plainly to the user. Give the source the figure came from. Roiva checks it as the form would and says what to fix. A second call for the same initiative, metric and month replaces your earlier proposal. It takes only the month list_requested_readings asks for; earlier months since the initiative went live, the ones on its Past months page, go in one propose_past_readings call.

search_roiva

ChatGPT
Search the user's Roiva account: initiatives, the app's pages, metric definitions (Roiva's library and the account's own), connections and the platforms not yet connected, vendors on cost entries, people, initiative templates, help articles, and active assessments. Use this to find IDs before calling other tools, or a page URL to send the user to.

withdraw_proposal

ChatGPT
Withdraw one of your own proposals that is still waiting for a person. It changes nothing else.

Capabilities

Writes

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/roiva"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/roiva)