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.

Related MCP server: macalc

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.