Tiendanube MCP
Tiendanube and Nuvemshop developer docs, API endpoint, scope and webhook lookups
- Pricing
- Open source
- Platforms
- CLI, self-hosted
- Runs
- Locally
- Version
- 0.1.0
- Listing updated
- today
Similar MCP servers
About Tiendanube MCP
Tiendanube MCP is an open-source MCP server for e-commerce. It runs locally on your machine and is started by your AI client.
This server is for people building partner apps or custom integrations on Tiendanube and Nuvemshop, not for running a store. Its README points store operators to the platform's official Admin MCP instead. Here an assistant can answer which endpoint, OAuth scope or webhook event a task needs and receive generated code for parts every app repeats.
Indexes for Admin API version 2025-03 work without a network: 228 endpoints with their required scopes and reference pages, 18 OAuth scope groups and 57 webhook events, with the three mandatory privacy events listed separately. Documentation search and reading hit nuvemshop.dev live in English, Portuguese or Spanish, and only memory holds it, since that documentation has no open licence.
Scaffolding tools return an Express and TypeScript webhook receiver with signature verification and a test, plus an OAuth install flow. The server asks for no store token, writes nothing to disk and connects only to nuvemshop.dev and tiendanube.dev. The README is in Spanish.
Install
Run in a terminal
claude mcp add tiendanube-mcp -- npx -y @commenteme/tiendanube-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"tiendanube-mcp": {
"command": "npx",
"args": [
"-y",
"@commenteme/tiendanube-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"tiendanube-mcp": {
"command": "npx",
"args": [
"-y",
"@commenteme/tiendanube-mcp"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"tiendanube-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@commenteme/tiendanube-mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"tiendanube-mcp": {
"command": "npx",
"args": [
"-y",
"@commenteme/tiendanube-mcp"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"tiendanube-mcp": {
"command": "npx",
"args": [
"-y",
"@commenteme/tiendanube-mcp"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Tools this server provides (7)
Taken from the project documentation; the running server may differ.
- search-docs
- Searches the documentation index and cites the best sections.
- read-doc
- Reads a documentation page or section by URL or path.
- lookup-endpoint
- Finds an Admin API endpoint with full URL, scope and reference.
- lookup-scope
- Returns OAuth scopes and the resources they open.
- lookup-webhook-event
- Lists webhook events by group with registration and verification steps.
- scaffold-webhook-handler
- Returns an Express TypeScript webhook receiver with a test.
- scaffold-oauth-callback
- Returns an Express OAuth install flow.
What it does
- Live docs search
- search-docs and read-doc read official documentation in three languages and cite the page URL.
- Endpoint index
- 228 Admin API endpoints with scope and reference link, available offline.
- Scope lookup
- The 18 OAuth scope groups and the resources they open.
- Webhook events
- 57 events with how to register and verify them.
- Webhook scaffold
- Express receiver with signature check and a node:test test.
- OAuth scaffold
- Install flow with state, code exchange and per-store registration.
Good for
- Find the scope an endpoint needs
- Generate a webhook receiver for order/paid and app/uninstalled
- Create an OAuth install flow for a partner app
- Look up webhook events for fulfillment orders
Pricing
Open source
MIT licence
Tiendanube MCP FAQ
Does it need store credentials?
No. It asks for no store token and only connects to nuvemshop.dev and tiendanube.dev.
Can it manage my store?
No. For operating a store the README recommends the official Admin MCP.
What does it require?
Node 18 or later; clients run it with npx.
What licence applies?
MIT.
Is Tiendanube MCP free?
Yes. Tiendanube MCP is open source, so you can use and self-host it for free.
How do I add Tiendanube MCP to Claude Code?
Run this command in your terminal: claude mcp add tiendanube-mcp -- npx -y @commenteme/tiendanube-mcp
What are the best alternatives to Tiendanube MCP?
The closest alternatives to Tiendanube MCP are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.


