@codespar/mcp-tiny (io.github.codespar/mcp-tiny)

MCP server for Tiny ERP that exposes business data for products, stock, warehouses, price lists, orders, invoices, and accounts payable/receivable (AP/AR). It is distributed as the @codespar/mcp-tiny npm package and includes a setup example for Claude Desktop using npx and TINY_API_TOKEN.

🛠️ Key Features

Tiny ERP integrations: products and stock
Warehouses and price lists
Orders and invoices
Accounts payable/receivable (AP/AR)
Uses MCP (model context protocol)

🚀 Use Cases

Retrieve and manage Tiny ERP catalog and transactional records
Support agentic-commerce workflows for order and invoice handling
Enable open-finance or payments-related tooling tied to Tiny ERP

⚡ Developer Benefits

npm install/run via npx -y @codespar/mcp-tiny
Configurable with TINY_API_TOKEN for authenticated access
Compatible with Claude Desktop MCP server configuration

⚠️ Limitations

Setup example shown only for Claude Desktop; no other clients are described in the provided data.

@codespar/mcp-tiny

MCP server for Tiny ERP — products, orders, contacts, invoices, stock, and accounts payable

Quick Start

Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json:

json

{
  "mcpServers": {
    "tiny": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-tiny"],
      "env": {
        "TINY_API_TOKEN": "your-token"
      }
    }
  }
}

Claude Code

bash

claude mcp add tiny -- npx @codespar/mcp-tiny

Cursor / VS Code

Add to .cursor/mcp.json or .vscode/mcp.json:

json

{
  "servers": {
    "tiny": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-tiny"],
      "env": {
        "TINY_API_TOKEN": "your-token"
      }
    }
  }
}

Tools (21)

Tool	Purpose
`list_products`	List products in Tiny ERP
`get_product`	Get product details by ID
`list_orders`	List sales orders in Tiny ERP
`get_order`	Get order details by ID
`list_contacts`	List contacts in Tiny ERP
`get_contact`	Get contact details by ID
`create_invoice`	Create a fiscal invoice (NF-e) from an order in Tiny
`get_invoice`	Get invoice details by ID
`get_stock`	Get current stock for a product
`list_accounts_payable`	List accounts payable in Tiny ERP
`update_stock`	Update (adjust) product stock balance — credit or debit a quantity for a deposit
`list_categories`	List product categories as a tree in Tiny ERP
`list_warehouses`	List stock warehouses (depósitos) configured in Tiny ERP
`list_price_lists`	List price lists (listas de preços) configured in Tiny ERP
`update_order_status`	Change a sales order's status — useful for cancelling or marking as approved/billed
`list_invoices`	List fiscal invoices (NF-e/NFC-e) in Tiny ERP
`get_invoice_xml`	Get the XML payload of an issued invoice (NF-e)
`get_invoice_link`	Get the DANFE PDF/link for an issued invoice
`send_invoice_email`	Email an issued invoice to a recipient
`list_accounts_receivable`	List accounts receivable in Tiny ERP
`get_account_receivable`	Get a single accounts-receivable record by ID

Authentication

Tiny uses a token parameter passed in each request.

Sandbox / Testing

Tiny provides test access via account registration.

Get your credentials

Go to Tiny ERP
Create an account
Navigate to API settings to generate a token
Set the TINY_API_TOKEN environment variable

Environment Variables

Variable	Required	Description
`TINY_API_TOKEN`	Yes	API token from Tiny ERP

Roadmap

v0.2 (planned)

create_product — Create a new product
update_product — Update product details
create_contact — Create a contact (customer/supplier)
update_contact — Update contact details
get_financial_summary — Get financial summary report

v0.3 (planned)

fiscal_reports — Generate fiscal reports (NF-e, NFS-e)
multi_company — Multi-company management

Want to contribute? Open a PR or request a tool.

Enterprise

Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

License

MIT

io.github.codespar/mcp-tiny