# Olist Tiny ERP

Olist Tiny ERP — an MCP server for the Olist Tiny e-commerce ERP. Your agent reads orders, stock, invoices and finance figures through the official REST API v3.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 302 installs
- Author: mcp-dir
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/mcp-dir/olist-mcp
- Updated: 2026-08-30
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/olist-tiny-erp

## What it does

A hosted MCP server that opens Olist Tiny, the former Tiny ERP, to a coding agent. Products, warehouse levels, sales orders, NF-e and NFC-e invoices, receivables and payables, contacts, shipping, CRM and price lists all arrive through the official REST API v3. You phrase the question; the agent picks the call.

Routing runs through one entry point, the `search_tools` tool, which looks the operation up in the catalog. Setup is a URL in the client config: on Claude run `claude mcp add --transport http olist-tiny-erp https://olist-mcp--mcp-dir.run.tools`.

Before the first query you register an app in your own Olist account and authorize it over OAuth. Every tool is read-only, so nothing you ask gets written back to the ERP and order changes still belong in Olist itself. Whatever the tools return lands in the LLM host you picked, and the authors advise a plan that opts out of training on it. The hosted server is proprietary; the repo holding manifests and docs is MIT. The authors pitch it next to Banco MCP for bank reconciliation.

## Requirements
- Remote server: `https://olist-mcp--mcp-dir.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http olist-mcp https://olist-mcp--mcp-dir.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add olist-tiny-erp --url https://olist-mcp--mcp-dir.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "olist-tiny-erp": {
            "url": "https://olist-mcp--mcp-dir.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "olist-tiny-erp": {
            "type": "http",
            "url": "https://olist-mcp--mcp-dir.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http olist-tiny-erp https://olist-mcp--mcp-dir.run.tools
```

## When to use it
- check warehouse stock before reordering from a supplier
- pull the week's orders and see what has shipped
- list receivables still open this month
- match bank deposits against ERP entries
- look up the NF-e status on a given order

## Example prompts
- Show me orders from the past week and flag the ones not shipped yet.
- How many units of product `X` are in stock right now?
- List unpaid receivables for the current month.

## Similar
- [Bling](https://affpapa.org/en/nevibecode/mcp/bling.md) — MCP server · 489 installs
- [mcp-tiny](https://affpapa.org/en/nevibecode/mcp/mcp-tiny.md) — MCP server · ★ 279 repo stars
- [Kingdee K3Cloud (Cloud Galaxy) ERP](https://affpapa.org/en/nevibecode/mcp/kingdee-k3cloud-cloud-galaxy-erp.md) — MCP server · ★ 146 repo stars
- [Frihet ERP](https://affpapa.org/en/nevibecode/mcp/frihet-erp.md) — MCP server · ★ 13 repo stars
- [erp-integration-analysis](https://affpapa.org/en/nevibecode/skills/erp-integration-analysis.md) — skill · 117 installs
- [ERP Facts](https://affpapa.org/en/nevibecode/mcp/erp-facts.md) — MCP server

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
