Octura Solutions Site Tools

Octura Solutions Site Tools (MCP server)

A hosted Model Context Protocol server exposing 30 read-only tools: 25 deterministic ERP calculators (Odoo implementation, migration and upgrade costs, ROI and total cost of ownership, sales tax for the US, Canada and the EU, Canadian payroll source deductions, and inventory maths like reorder point, safety stock and EOQ) plus five content lookups that return Octura pages, Odoo pricing and competitor comparisons to cite.

Endpoint: https://octurasolutions.com/mcp (streamable HTTP) Registry: com.octurasolutions/site-tools

Nothing to install and no API key. It is a remote server, so you point your client at the URL.

Why these are tools and not a chat answer

Every calculator is a pure function: same inputs, same outputs, no model in the loop and no randomness. Asking a language model to compute a payback period or a Quebec QST total invites a plausible-looking wrong number. These return the arithmetic instead, along with the inputs they used, so the result can be checked.

The trade-off is that they are calculators, not advice. They do not know your business, and the cost models carry assumptions (regional rates, blended hourly costs) that a real quote would replace.

Add it to your client

Claude Code:

claude mcp add --transport http octura https://octurasolutions.com/mcp

Any client that reads a JSON config:

{
  "mcpServers": {
    "octura": {
      "type": "streamable-http",
      "url": "https://octurasolutions.com/mcp"
    }
  }
}

The server is stateless and tools-only. It implements initialize, ping, tools/list and tools/call; it advertises no resources and no prompts.

If your client only speaks stdio

Most clients handle remote HTTP directly and should use the config above. For older ones that only support stdio, this repo ships a bridge:

npx -y github:Octura-solutions/octura-mcp-server

{
  "mcpServers": {
    "octura": {
      "command": "npx",
      "args": ["-y", "github:Octura-solutions/octura-mcp-server"]
    }
  }
}

Or with Docker, docker build -t octura-mcp . && docker run -i --rm octura-mcp.

Python clients can install it from PyPI instead:

uvx octura-mcp-server

{
  "mcpServers": {
    "octura": {
      "command": "uvx",
      "args": ["octura-mcp-server"]
    }
  }
}

The Node bridge runs from this repo rather than an npm package name, because it is not published to npm; the Python one is on PyPI. Both are the same pipe with the same behaviour, verified by the same eight tests in each language. Pick whichever runtime your client already has.

The bridge is a pipe: it POSTs whatever arrives on stdin to the endpoint and writes the reply back. It has no dependencies and it does not restate the tool list or any schema, so it cannot drift out of sync with the server. Point it elsewhere with OCTURA_MCP_URL.

A worked example

curl -s -X POST https://octurasolutions.com/mcp \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{
        "name":"odoo-roi-calculator",
        "arguments":{"currentAnnualCost":60000,"odooAnnualCost":18000,
                     "implementationCost":45000,"annualEfficiencySavings":30000}}}'

The text content is JSON, echoing the input alongside the result:

{
  "tool": "odoo-roi-calculator",
  "input": {
    "currentAnnualCost": 60000,
    "odooAnnualCost": 18000,
    "implementationCost": 45000,
    "annualEfficiencySavings": 30000
  },
  "result": {
    "annualNetSavings": 72000,
    "paybackMonths": 7.5,
    "threeYearNet": 171000,
    "threeYearRoiPercent": 380
  }
}

Every input has a documented default, so a tool called with {} still returns a sensible baseline rather than an error.

The tools

Each one also exists as an interactive page, which is the easiest way to see what a tool expects before wiring it up.

Odoo cost and planning

Tool	What it returns
odoo-implementation-cost-calculator	Estimate your Odoo implementation budget
odoo-migration-cost-calculator	Estimate the cost to migrate to Odoo
odoo-upgrade-cost-calculator	Budget an Odoo version upgrade
odoo-total-cost-of-ownership-calculator	Model the multi-year total cost of Odoo
odoo-roi-calculator	Estimate payback and multi-year ROI of Odoo
odoo-sh-pricing-calculator	Estimate your Odoo.sh hosting cost
odoo-stack-savings-calculator	See what consolidating tools into Odoo saves
odoo-edi-readiness-cost-estimator	Estimate EDI integration cost in Odoo
odoo-app-selector	Find the Odoo apps your business needs
erp-selection-tool	Score your best-fit ERP shortlist across 10 systems
odoo-conf-tuner	Tune odoo.conf workers and memory limits
odoo-project-rescue-risk-grader	Grade how badly an in-flight Odoo implementation is going

Tax

Tool	What it returns
us-sales-tax-calculator	State sales tax for all 50 states and DC
us-sales-tax-nexus-checker	See where you must collect US sales tax
canadian-sales-tax-calculator	GST, HST, PST and QST for all provinces
eu-vat-calculator	VAT rates by country plus VIES validation
canadian-payroll-source-deductions-calculator	CPP, EI and income tax source deductions

Inventory and operations

Tool	What it returns
inventory-turnover-calculator	Turnover ratio and days of inventory
reorder-point-calculator	When to reorder, with safety stock
safety-stock-calculator	Buffer stock for demand and lead-time swings
economic-order-quantity-calculator	Optimal order quantity to minimize cost
inventory-carrying-cost-calculator	Annual cost of holding inventory
landed-cost-calculator	True per-unit cost including freight and duty
margin-and-markup-calculator	Convert between margin, markup and price
oee-calculator	Overall Equipment Effectiveness for production

Octura content

These are lookups rather than calculators. They return pages and facts from octurasolutions.com so a model can answer with a source to cite instead of from memory.

Tool	What it returns
ask_octura	The most relevant site pages for an Odoo or ERP question, with URLs
compare_odoo_vs	Head-to-head comparison of Odoo against one of 60 competitors
find_odoo_apps_for	Odoo apps and modules that fit a business need in plain language
get_odoo_pricing	Current Odoo license list pricing and Odoo.sh hosting rates
get_partner_profile	Who Octura Solutions is: partner status, regions, services, contact

Machine-readable descriptions

For catalogs, plugin loaders and anything else that wants the API described without speaking MCP first, the repo carries three files:

File	What it is
tools.json	The tools/list reply verbatim, plus the serverInfo from initialize
openapi.json	OpenAPI 3.1 for the endpoint, with a typed request schema per tool
.well-known/ai-plugin.json	Plugin manifest pointing at the OpenAPI document

The first two are generated from the live endpoint by npm run discovery, so they are a snapshot rather than a second source of truth: if they disagree with the server, the server is right and the fix is to rerun the script. npm test checks that the three files agree with each other.

Limits

Rate limited per IP. Read X-RateLimit-Limit and X-RateLimit-Remaining on the response rather than hard-coding a number, since the ceiling can change. Over the limit returns HTTP 429 with a Retry-After header.

Tax rates and payroll figures are maintained on a best-effort basis and are not a substitute for filing advice from an accountant.

About this repository

This repo is the public home of the server: this README, a copy of the published server.json registry manifest, the machine-readable descriptions above, and the stdio bridge. The calculators themselves run inside the Octura Solutions website, whose source is private, so what you can build and run here is the bridge rather than the tools.

Run the bridge's tests with npm test. They use a local stand-in for the endpoint, so they pass with no network access.

Details on the server, including the full tool list with input schemas, are at octurasolutions.com/tools/mcp-server.

Found a wrong number or a tool that errors? Open an issue.

License

MIT, see LICENSE. This covers the contents of this repository. The hosted service is offered as-is under the terms on the website.