Octura Solutions Site Tools (MCP server)

A hosted Model Context Protocol server exposing 24

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.

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 tool 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

Tax

Inventory and operations

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, and the stdio bridge described above. 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.