# Tharstern MCP by usefulapi

> Tharstern MCP by usefulapi is a freemium MCP server. Hosted MCP server that lets AI assistants read Tharstern jobs, quotes, stock and invoices. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9 a month
- **Platforms:** Web, API, CLI, vscode
- **Website:** https://usefulapi.io/tharstern/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/tharstern
- **MCP Registry name:** io.usefulapi/tharstern
- **Listing updated:** 2026-11-18

## About

The server connects an AI client to a Tharstern account so you can query production jobs, estimates, sales orders, invoices, delivery notes and stock levels in plain language. The AI chooses which of the 23 exposed tools to call, and the server signs in with your own Tharstern user credentials through OAuth.

The 19 data tools are read-only, so the assistant can look up and summarise records but cannot change them. Access is limited to what your Tharstern user is allowed to see. The README describes the hosted endpoint as needing no local install, with a separate MIT-licensed documentation repository.

The server is aimed at print shops and similar production businesses that use Tharstern for planning jobs, quotes and stock, and who want quick answers from Claude, ChatGPT, Cursor or VS Code. usefulapi states it is an independent service and not affiliated with Tharstern.

## Features

- **Read-only Tharstern access:** Nineteen data tools list and search customers, jobs, estimates, orders, invoices and stock without modifying records.
- **Job and estimate lookup:** Search production jobs by progress flags and dates, and find estimates still waiting for a decision.
- **Product price by quantity:** Return the price of a single product for a given quantity, optionally for a specific customer.
- **Stock and purchase order checks:** Read stock balances with locations and list purchase orders filtered by status.
- **OAuth sign-in:** Log in with Tharstern user credentials in the browser, so no API key is placed in client configuration files.
- **Usage metering:** A free tier of 50 tool calls per month, with usage status available through a dedicated tool.

## Good for

- Check which production jobs are due this week and which remain unfinished
- Follow up on estimates that have not yet been accepted or rejected
- Quote a product price for a specific quantity during a customer call
- Review open purchase orders with suppliers and stock levels by location
- See which shop-floor operators are working on which operations

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http tharstern https://tharstern.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://tharstern.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "tharstern": {
      "url": "https://tharstern.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "tharstern": {
      "type": "http",
      "url": "https://tharstern.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "tharstern": {
      "serverUrl": "https://tharstern.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "tharstern": {
      "type": "http",
      "url": "https://tharstern.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `tharstern_list_customers`: List or search customers, with optional delivery addresses and custom fields.
- `tharstern_list_suppliers`: List suppliers, optionally by id, code or tax registration number.
- `tharstern_list_estimates`: Search estimates (quotes) by reference, customer, dates, status or custom status.
- `tharstern_list_jobs`: Search production jobs by number, customer, dates and progress flags.
- `tharstern_list_orders`: Search sales orders by number, customer, dates or status.
- `tharstern_list_delivery_notes`: Search delivery notes by number, order, job, status or last change date.
- `tharstern_list_invoices`: List sales invoices by number, job, order, customer or date range.
- `tharstern_list_purchase_orders`: List purchase orders filtered by status.
- `tharstern_list_products`: Search the product inventory, including stock balances and optionally locations.
- `tharstern_get_product_price`: Get the price of one product for a quantity, optionally for one customer.
- `tharstern_list_stock_locations`: List stock locations, optionally with their contents.
- `tharstern_list_projects`: Search projects by number, customer, title or required date.
- `tharstern_list_tasks`: List tasks, optionally open only, and filter by assignee, customer or project.
- `tharstern_list_notes`: List notes, optionally for one module and date range.
- `tharstern_list_operators`: List shop-floor operators, optionally by department.
- `tharstern_list_working_operations`: List operations that operators are working on now or worked on.
- `tharstern_list_milestones`: List all job milestone definitions.
- `tharstern_list_currencies`: List the currencies defined on the Tharstern system.
- `tharstern_get_licence`: Get the Tharstern licence details: version, users, expiry and enabled modules.

## FAQ

### Is this an official Tharstern product?

No. usefulapi is an independent service and is not affiliated with or endorsed by Tharstern. The server calls the Tharstern API with your own access.

### Can the AI change my Tharstern data?

No. The page states that all 19 Tharstern data tools are read-only.

### What does it cost?

The Free plan includes 50 tool calls per month. Pro is $9 per month or $90 per year with 10,000 calls, and Pro+ is $39 per month or $390 per year with 100,000 calls. Each subscription covers this server only.

### Which AI clients can connect?

Any client that supports remote MCP servers over Streamable HTTP with OAuth login, including Claude, ChatGPT, Claude Code, Cursor, VS Code and Codex.

### Is Tharstern MCP by usefulapi free?

Tharstern MCP by usefulapi has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.

### How do I add Tharstern MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http tharstern https://tharstern.usefulapi.io/mcp

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

---
Source: https://ai-powered.com/mcp/tharstern-mcp-by-usefulapi
