# Ginesys MCP by usefulapi

> Ginesys MCP by usefulapi is a freemium MCP server for sales and crm. Hosted MCP server connecting AI clients to Ginesys ERP for items, sales orders and stock. 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:** API, Web
- **Website:** https://usefulapi.io/ginesys-erp/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/ginesys-erp
- **MCP Registry name:** io.usefulapi/ginesys-erp
- **Categories:** sales and CRM
- **Listing updated:** 2026-11-18

## About

The README says this is a hosted connector rather than a local install, so there is nothing to run on your machine. Once added to an MCP client, it lets an assistant look up inventory items by code or barcode, read their prices and tax settings, and create sales orders with item lines.

It also reserves stock for lines of an existing sales order at a chosen site and cancels part or all of such a reservation. Orders can be found by Ginesys order code or by your own integration order id, which the server asks you to set so that retries do not create duplicates.

Access is through your own Ginesys API address and API key, entered at login over OAuth, and calls run against what that API user can see. The server suits retail and distribution teams who already work in Ginesys ERP and want an assistant to handle routine lookups and order updates. Usage is metered per tool call, with a free tier and paid plans.

## Features

- **Item lookup:** Fetches one inventory item by item code or barcode, including prices, tax group and stock settings.
- **Sales order creation:** Creates a sales order with item lines and accepts a custom order id to prevent duplicates.
- **Stock reservation:** Reserves stock for lines of an existing sales order at a specified site.
- **Reservation cancellation:** Cancels part or all of a stock reservation on sales order lines.
- **OAuth login:** Signs in through a login page using the Ginesys API address and key, so no keys go into client config files.
- **Usage reporting:** Reports current plan, monthly calls used and remaining allowance.

## Good for

- Check an item's price and tax group while talking to an assistant
- Create a sales order for a set of item lines at a given site
- Reserve stock on an existing sales order for a specific site
- Release part of a stock reservation when quantities change

## Install

### Claude Code (Terminal)

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

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

```sh
https://ginesys-erp.usefulapi.io/mcp
```

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

```json
{
  "mcpServers": {
    "ginesys-erp": {
      "url": "https://ginesys-erp.usefulapi.io/mcp"
    }
  }
}
```

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

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

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

```json
{
  "mcpServers": {
    "ginesys-erp": {
      "serverUrl": "https://ginesys-erp.usefulapi.io/mcp"
    }
  }
}
```

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

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

## Tools

- `ginesys_get_item`: Get one inventory item by item code or barcode.
- `ginesys_create_sales_order`: Create a sales order with its item lines in Ginesys ERP.
- `ginesys_create_reservation`: Reserve stock for lines of an existing sales order at a site.
- `ginesys_cancel_reservation`: Cancel part or all of a stock reservation on sales order lines.
- `ginesys_usage_status`: Report the caller's current usage and plan limit.
- `ginesys_request_feature`: Send a request for a capability the Ginesys tools cannot yet provide.
- `ginesys_upgrade`: Get a paid Pro or Pro+ plan for the Ginesys server.
- `ginesys_cancel_subscription`: Cancel the Pro subscription at the end of the paid period.

## FAQ

### What can I do with Ginesys in Claude or ChatGPT?

Look up an item's price and tax group, create a sales order for item lines, reserve stock for an existing order, and cancel part of a stock reservation.

### Is this an official Ginesys product?

No. The listing states usefulapi is an independent service, not affiliated with or endorsed by Ginesys.

### What do I need to connect?

The login page asks for your Ginesys API address (your tenant) and Ginesys API key, which you create in Ginesys ERP under Admin, Security, API User.

### What does it cost?

The Free plan gives 50 tool calls a month. Pro is $9/mo or $90/yr with 10,000 calls a month, and Pro+ is $39/mo or $390/yr with 100,000 calls a month.

### Is Ginesys MCP by usefulapi free?

Ginesys 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 Ginesys MCP by usefulapi to Claude Code?

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

### What are the best alternatives to Ginesys MCP by usefulapi?

The closest alternatives to Ginesys MCP by usefulapi are Calven, CompanyData, MisarReach MCP Server, NeuralVerge and ZUUZ.

## 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.

## Alternatives

- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [MisarReach MCP Server](https://ai-powered.com/mcp/misarreach-mcp-server): MisarReach MCP Server is a freemium MCP server for sales and crm.
- [NeuralVerge](https://ai-powered.com/mcp/neuralverge): NeuralVerge is an MCP server for web search and scraping.
- [ZUUZ](https://ai-powered.com/mcp/zuuz): ZUUZ is an MCP server for sales and crm.
- [Fuse](https://ai-powered.com/mcp/fuse-2): Fuse is a freemium MCP server for sales and crm.
- [Gender-API.com](https://ai-powered.com/mcp/gender-api-com): Gender-API.com is a freemium MCP server for analytics and data.
- [Dialvett: Bulk Phone Number Validator & Carrier Lookup](https://ai-powered.com/mcp/dialvett-bulk-phone-number-validator-and-carrier-lookup): Dialvett: Bulk Phone Number Validator & Carrier Lookup is a paid MCP server for analytics and data.

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