mcp-tiny

Name: mcp-tiny
Author: codespar

Local

github.com/codesparBusiness & Marketing275Updated 4w ago

Repository

About mcp-tiny

@codespar/mcp-tiny is an MCP server for Tiny ERP, covering products, orders, contacts, invoices, stock, and accounts payable and receivable. It is intended for users who want MCP clients to work with ERP data from this Brazilian system. Setup requires a Tiny API token.

Key features

01Product and sales order query tools
02Stock lookup and balance adjustment
03Warehouse and price list listing
04NF-e invoice creation, retrieval and email sending
05Accounts payable and receivable lookup
06Configuration through the TINY_API_TOKEN variable

Use cases

01Letting an AI assistant check stock and adjust balances
02Generating NF-e invoices from orders and emailing them
03Reviewing the status of receivables and payables

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config

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

Run commandnpx -y @codespar/mcp-tiny

Environment variables to set

TINY_API_TOKENSecretAPI key for tiny

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages

npm@codespar/mcp-tiny0.2.2stdio

Tools

Saved tool list · updated 2w ago

Parameter	Type	Required	Description
pagina	number	No	Page number (default 1)
pesquisa	string	No	Search term (name, code, or barcode)

Details

From the project README

@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:

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

Claude Code

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

Cursor / VS Code

Add to .cursor/mcp.json or .vscode/mcp.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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

Read the getting-started guide

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.