# Tiny (Olist Tiny) — MCP server on mcp.ai
> Tiny (Olist Tiny) e-commerce ERP, one of the most used by online stores and marketplace sellers in Brazil. Query products and stock, sales orders, contacts, invoices and payables/receivables, and create contacts, via the official API. Pairs with the Banco MCP to reconcile orders and finances with the bank statement. Auth via token (generated in the Tiny account, in the Token API extension).

By: mcp.ai · official
Page: https://mcp.ai/tiny

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_tiny?ms=1786693920000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/tiny/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/tiny/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/tiny/skill.md
Postman collection (v2.1): https://mcp.ai/tiny/postman.json

## Tools
- tiny_create_contact(data: string, account?: string) — Cadastra um contato (cliente/fornecedor) — contato.incluir.php. `data` é um JSON string com os campos do contato conforme a doc oficial (comuns: nome, tipoPessoa 'F'|'J', cpf_cnpj, email, fone, endere
- tiny_get_contact(id: string|number, account?: string, ids?: string|number[]) — Detalha um contato pelo `id` (contato.obter.php).
- tiny_get_invoice(id: string|number, account?: string, ids?: string|number[]) — Detalha uma nota fiscal pelo `id` (nota.fiscal.obter.php).
- tiny_get_order(id: string|number, account?: string, ids?: string|number[]) — Detalha um pedido pelo `id` (pedido.obter.php).
- tiny_get_product(id: string|number, account?: string, ids?: string|number[]) — Detalha um produto pelo `id` (produto.obter.php).
- tiny_get_product_stock(id: string|number, account?: string, ids?: string|number[]) — Saldo de estoque de um produto pelo `id` (produto.obter.estoque.php).
- tiny_list_accounts(account?: string) — Lista as empresas (CNPJ) Tiny conectadas a este install — id, label.
- tiny_list_contacts(search?: string, page?: integer, filters?: string, account?: string) — Pesquisa contatos (contatos.pesquisa.php). Paginado. `search` busca por nome; `filters` (JSON) aceita cpf_cnpj, situacao, idVendedor etc.
- tiny_list_invoices(search?: string, page?: integer, filters?: string, account?: string) — Pesquisa notas fiscais (notas.fiscais.pesquisa.php). Paginado. `filters` (JSON) aceita dataInicial/dataFinal (DD/MM/AAAA), situacao, numeroNota, cpf_cnpj etc.
- tiny_list_orders(search?: string, page?: integer, filters?: string, account?: string) — Pesquisa pedidos de venda (pedidos.pesquisa.php). Paginado. `filters` (JSON) aceita dataInicial/dataFinal (DD/MM/AAAA), situacao, numeroPedido, nomeCliente, cpf_cnpj etc.
- tiny_list_payables(search?: string, page?: integer, filters?: string, account?: string) — Lista contas a pagar (contas.pagar.pesquisa.php). Paginado. `filters` (JSON) aceita dataInicial/dataFinal (DD/MM/AAAA), situacao (aberto/pago), nomeCliente etc. Pareia com o Banco MCP na conciliação.
- tiny_list_products(search?: string, page?: integer, filters?: string, account?: string) — Pesquisa produtos (produtos.pesquisa.php). Paginado. Use `search` pra buscar por nome/código e `filters` (JSON) pra situacao, idCategoria, etc.
- tiny_list_receivables(search?: string, page?: integer, filters?: string, account?: string) — Lista contas a receber (contas.receber.pesquisa.php). Paginado. `filters` (JSON) aceita dataInicial/dataFinal (DD/MM/AAAA), situacao (aberto/recebido), nomeCliente etc.
- tiny_list_sellers(search?: string, page?: integer, filters?: string, account?: string) — Pesquisa vendedores (vendedores.pesquisa.php). Paginado. `search` busca por nome.

## Example prompts
- "Which sales orders came in over the last 7 days?"
- "What's the stock for product SKU ABC?"
- "List open receivables to reconcile with the bank"

## Links
Docs: https://mcp.ai/docs/mcps/tiny
Website: https://mcp.ai/mcps/tiny