Tiny (Olist Tiny)

io.github.mcp-dirPublished by GitHub account mcp-dirv0.1.0Updated Oct 25, 2026

Tiny (Olist Tiny) e-commerce ERP, one of the most used by online stores and marketplace sellers in B

VerifiedStreamable HTTPWeb executableProductivity & WorkflowFinanceBusiness & Commerce

Overview

AI-generated overview

Remote MCP server for the Tiny (Olist Tiny) Brazilian e-commerce ERP, letting an assistant query products, stock, orders, contacts, invoices and finances, and 註

What you can do
List connected Tiny companies and search products, sellers and contacts, with detail and stock lookups by id, including batched ids for details and stock. Search and detail sales orders by id, with date, status, order number and customer filters. Search and detail invoices and contacts, and create a new contact (customer or supplier) from a JSON payload. List payables and receivables with date and status filters for reconciliation. Check platform versions, report bugs, inspect toolkit and connection status, and search the marketplace catalog.
When to use it
Useful when an assistant needs to answer questions about a Brazilian online store's Tiny ERP data — recent orders, product stock, open receivables — or to register new contacts without opening the ERP. Suited to sellers and stores already running Tiny who want conversational access to their operational and financial records.
Requirements
Remote MCP over HTTP at the provider's endpoint; no local package. A Tiny account with an API token generated in the Tiny account (Token API extension), plus login through the provider's magic-link flow or an access token supplied as an Authorization Bearer header. A compatible MCP client such as Claude, Cursor, VS Code or ChatGPT.
Before you install
The server can write: creating contacts adds records to the ERP. It handles business and customer data (CNPJ, CPF, contacts, invoices, finances), which is sent to whichever LLM host you choose, outside the provider's control. Authentication uses a Tiny API token and a provider access token; treat both as secrets. The hosted server is proprietary and paid plans start from a free tier.

Installation

In SourceWeft

  1. Open Tiny (Olist Tiny) in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.mcp-dir%2Ftiny-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "tiny-olist-tiny": {
      "type": "http",
      "url": "https://api.mcp.ai/p_tiny"
    }
  }
}

README

Tiny (Olist Tiny)

Tiny (Olist Tiny) para Claude, ChatGPT e agentes de IA

ERP de e-commerce Tiny (Olist Tiny), um dos mais usados por lojas virtuais e sellers de marketplace no Brasil. Consulta produtos e estoque, pedidos de venda, contatos, notas fiscais e contas a pagar/receber, e cadastra contatos, via API oficial. Pareia com o Banco MCP pra conciliar pedidos e financeiro com o extrato. Autenticação por token (gerado na conta Tiny, na extensão Token API).

  • 📊 14 ferramentas
  • ✏️ Leitura e escrita
  • 💬 Funciona com qualquer cliente MCP: Claude Desktop, Cursor, VS Code, Cline, Continue
  • 🔑 Login via magic-link (sem senha)

English version · Documentação completa · Skill pra agentes

Instalar em 1 clique

Claude (Web e Desktop)

A Anthropic unificou a instalação de MCPs em claude.ai/customize/connectors. O mesmo link serve pra Claude Web e Claude Desktop (basta estar logado):

➕ Abrir no Claude e conectar

Manual (se o deeplink não abrir): claude.ai/customize/connectors → + → Adicionar conector personalizado → cole Nome Tiny (Olist Tiny) e URL https://api.mcp.ai/p_tiny.

Cursor

➕ Instalar Tiny (Olist Tiny) no Cursor

VS Code (Copilot Chat)

➕ Instalar Tiny (Olist Tiny) no VS Code

ChatGPT, Manus, OpenClaw e mais 40+ clientes

Funciona em qualquer cliente MCP que suporte MCP over HTTP. A URL do servidor é sempre:

https://api.mcp.ai/p_tiny

Detalhes por cliente: INSTALL.md.

Exemplos de uso

Quais pedidos de venda entraram nos últimos 7 dias?Qual o estoque do produto SKU ABC?Liste as contas a receber em aberto pra conciliar com o banco

14 ferramentas disponíveis

ToolDescrição
tiny_list_accountsLista as empresas (CNPJ) Tiny conectadas a este install — id, label.
tiny_list_productsPesquisa produtos (produtos.pesquisa.php).
tiny_get_productDetalha um produto pelo id (produto.obter.php).
tiny_get_product_stockSaldo de estoque de um produto pelo id (produto.obter.estoque.php).
tiny_list_ordersPesquisa pedidos de venda (pedidos.pesquisa.php).
tiny_get_orderDetalha um pedido pelo id (pedido.obter.php).
tiny_list_contactsPesquisa contatos (contatos.pesquisa.php).
tiny_get_contactDetalha um contato pelo id (contato.obter.php).
tiny_create_contactCadastra um contato (cliente/fornecedor) — contato.incluir.php.
tiny_list_invoicesPesquisa notas fiscais (notas.fiscais.pesquisa.php).
tiny_get_invoiceDetalha uma nota fiscal pelo id (nota.fiscal.obter.php).
tiny_list_payablesLista contas a pagar (contas.pagar.pesquisa.php).
tiny_list_receivablesLista contas a receber (contas.receber.pesquisa.php).
tiny_list_sellersPesquisa vendedores (vendedores.pesquisa.php).

Detalhe de cada tool: docs/ferramentas.md

Preços

Planos a partir do tier grátis. Veja docs/precos.md.

Privacidade & LGPD

  • Sub-processadores: Tiny (Olist), o LLM host que você escolher (Claude, ChatGPT, Cursor, agente próprio). Lista completa em docs/privacidade-lgpd.md.
  • Os dados retornados pelas tools são enviados ao LLM host que você escolher, sub-processador fora do nosso controle. Recomendamos planos com opt-out de treinamento.

Perguntas frequentes

O servidor é open source? O servidor é proprietário (hosted). Este repositório é o wrapper público com manifestos, docs e skills — tudo MIT.

Posso usar com agente próprio (não Claude/Cursor)? Sim — qualquer cliente que suporte MCP over HTTP. URL: https://api.mcp.ai/p_tiny.

Suporte

Licença

MIT — veja LICENSE. O servidor MCP em api.mcp.ai/p_tiny é proprietário (hosted); este repositório (manifestos, docs, skills) é MIT.

Source: README.md at commit 680589b

Tools

20

tiny_list_accounts

Lista as empresas (CNPJ) Tiny conectadas a este install — id, label.

Parametersaccount

tiny_list_products

Pesquisa produtos (produtos.pesquisa.php). Paginado. Use `search` pra buscar por nome/código e `filters` (JSON) pra situacao, idCategoria, etc.

Parameterspagesearchaccountfilters

tiny_get_product

Detalha um produto pelo `id` (produto.obter.php). Bulk support: accepts ids for batched execution.

Parametersidrequiredidsaccount

tiny_get_product_stock

Saldo de estoque de um produto pelo `id` (produto.obter.estoque.php). Bulk support: accepts ids for batched execution.

Parametersidrequiredidsaccount

tiny_list_orders

Pesquisa pedidos de venda (pedidos.pesquisa.php). Paginado. `filters` (JSON) aceita dataInicial/dataFinal (DD/MM/AAAA), situacao, numeroPedido, nomeCliente, cpf_cnpj etc.

Parameterspagesearchaccountfilters

tiny_get_order

Detalha um pedido pelo `id` (pedido.obter.php). Bulk support: accepts ids for batched execution.

Parametersidrequiredidsaccount

tiny_list_contacts

Pesquisa contatos (contatos.pesquisa.php). Paginado. `search` busca por nome; `filters` (JSON) aceita cpf_cnpj, situacao, idVendedor etc.

Parameterspagesearchaccountfilters

tiny_get_contact

Detalha um contato pelo `id` (contato.obter.php). Bulk support: accepts ids for batched execution.

Parametersidrequiredidsaccount

tiny_create_contact

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, endereco, cidade, uf, cep). Doc: tiny.com.br/api-docs (contato.incluir).

Parametersdatarequiredaccount

tiny_list_invoices

Pesquisa notas fiscais (notas.fiscais.pesquisa.php). Paginado. `filters` (JSON) aceita dataInicial/dataFinal (DD/MM/AAAA), situacao, numeroNota, cpf_cnpj etc.

Parameterspagesearchaccountfilters

tiny_get_invoice

Detalha uma nota fiscal pelo `id` (nota.fiscal.obter.php). Bulk support: accepts ids for batched execution.

Parametersidrequiredidsaccount

tiny_list_payables

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.

Parameterspagesearchaccountfilters

tiny_list_receivables

Lista contas a receber (contas.receber.pesquisa.php). Paginado. `filters` (JSON) aceita dataInicial/dataFinal (DD/MM/AAAA), situacao (aberto/recebido), nomeCliente etc.

Parameterspagesearchaccountfilters

tiny_list_sellers

Pesquisa vendedores (vendedores.pesquisa.php). Paginado. `search` busca por nome.

Parameterspagesearchaccountfilters

show_version

Show Version

Show the current MCP platform and adapter versions.

Takes no parameters.

report_bug

Report Bug

Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.

Parameterscontextmessagerequiredconversation

connect

Connection Status

Returns connection status and URLs. When all providers are connected, returns authenticated:true and empty pending[]. When credentials are missing, returns connect_url for the toolkit and per-install URLs.

Takes no parameters.

toolkit_info

Toolkit Info

Returns the current toolkit state: installed MCPs, their connection status, the accounts connected to each one, and how many catalog tools each exposes.

Takes no parameters.

marketplace

Marketplace

The official mcp.ai marketplace — the in-platform catalog of every MCP/tool, AND the way to run them. Covers capability requests like "find an MCP that does X", "consulta um CPF", "is there a tool for Y". Core flow: action=search discovers MCPs by intent → describe returns one MCP's full profile (every tool with its id + params, pricing, auth) so you pick the right tool_id → invoke RUNS that tool. KEY: invoke works even when the MCP is NOT installed — it runs the tool pontualmente (one-off), without adding the MCP to the toolkit and without bloating the tool list. If the MCP needs a credential/login, invoke returns a connect link; if it is paid and the wallet is empty, invoke returns a checkout/top-up link (the user opens it, then you retry). Use install only to make an MCP PERMANENT in the active toolkit (its tools then show up natively in future sessions); prefer invoke for a single/occasional use. list_tools lists what is callable right now. subscribe/cancel handle per-MCP billing; report_bug sends feedback; request_mcp asks us to build a NEW MCP when nothing fits. Search/describe flag installed_in_toolkit vs installed_in_workspace. Writes (install/uninstall/subscribe/cancel and the one-off install behind invoke) require workspace owner/admin. It also carries the mcp.ai PROMPT LIBRARY, which is about ready-made prompt TEXT rather than MCPs: search_prompts finds one, get_prompt returns its full text with {{variables}} filled, and publish_prompt saves a prompt and returns a shareable mcp.ai/p/<slug> link that opens without login.

Parameterslimitqueryactionmcp_idmessagetool_idargumentsimmediatetier_slugprompt_bodyprompt_slugprompt_tool+11 more

authenticate

Authenticate

MCP.AI for IDE agents (Cursor, etc.): log in in the browser, copy the access token. Best: add it to this server's config as a header `Authorization: Bearer <token>` for a permanent, non-expiring connection. Or paste it here for a session-only login: call with { token: "<jwt>" } after the user pastes, or with no args to get the link.

Parameterstoken

Version history

1
  1. v0.1.0LatestSep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts