Koskamo

mcp-dir Nuvemshop MCP

An MCP server for the Nuvemshop e-commerce platform that enables AI agents to manage store products, orders, customers, categories, and coupons via the official API using OAuth authentication.

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

mcp-dir Nuvemshop MCP logo, by mcp-dirCommunity listingStreamable HTTPNo sign-inEndpoint checked 2026-11-06Published by mcp-dir
You need:The platform provides the OAuth app, just click Authorize and log into your Nuvemshop store.
MCP endpoint (Streamable HTTP)
https://api.mcp.ai/p_nuvemshop
Vendor documentation

What its tools do

24 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.

24 of 24 have a description · 24 of 24 declare behavior hints · 0 of 21 with parameters document them all

Checks and signals

Each line is separate evidence, not a trust score.

  • Passed Endpoint answered the live check ·
  • Availability 1 of 1 checks passed in 30 days

What you can do with it

  • List open orders from the store
  • Check which products are out of stock
  • Create a 10% discount coupon named WELCOME

Source and maintenance

Community listingRegistry 0.1.0
Maintenance checked

Protocol and capabilities

Server
mcp-ai 0.9.409
MCP protocol negotiated in check
2025-11-25
Tools
24 advertised
Resources
Not advertised
Resource templates
Not advertised
Prompts
Not advertised
Server-advertised capabilities
{
  "tools": {
    "listChanged": true
  }
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

MCP.AI platform v0.9.409 | Adapters: nuvemshop vunknown. When the user asks about the version (e.g. "qual a versão", "which version"), call the show_version tool. NEW MCPs/tools/integrations (capabilities not already in this toolkit) come from the official mcp.ai catalog: the `marketplace` tool (action=search) finds and runs them. You are not authenticated yet. Call the authenticate tool first — it will give the user a browser link to log in and copy a token. No other tools will work until authenticated.

Tools

24 advertised

nuvemshop_list_accounts
Advertised by the server during the last successful anonymous check.
Advertised read-only

Lista lojas Nuvemshop vinculadas a este install — store_id, label e apelido.

nuvemshop_list_accounts input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "account": {
      "type": "string"
    }
  }
}
nuvemshop_list_accounts annotations
{
  "title": "nuvemshop_list_accounts",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
nuvemshop_products_list
Advertised by the server during the last successful anonymous check.
Advertised read-only

Leitura de produtos da loja Nuvemshop. Ações: - list: produtos paginados (params: page, per_page, q busca textual, category_id, published, created_at_min, updated_at_min). - get: produto por id (requer product_id). [Flattened action: list] Bulk support: accepts product_ids, category_ids for batched execution.

nuvemshop_products_list input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "q": {
      "type": "string"
    },
    "page": {
      "type": "number"
    },
    "account": {
      "type": "string"
    },
    "per_page": {
      "type": "number"
    },
    "published": {
      "type": "boolean"
    },
    "product_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        }
      ]
    },
    "category_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        }
      ]
    },
    "product_ids": {
      "type": "array",
      "items": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          }
        ]
      }
    },
    "category_ids": {
      "type": "array",
      "items": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          }
        ]
      }
    },
    "created_at_min": {
      "type": "string"
    },
    "updated_at_min": {
      "type": "string"
    }
  }
}
nuvemshop_products_list annotations
{
  "title": "nuvemshop_products_list",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
nuvemshop_products_get
Advertised by the server during the last successful anonymous check.
Advertised read-only

Leitura de produtos da loja Nuvemshop. Ações: - list: produtos paginados (params: page, per_page, q busca textual, category_id, published, created_at_min, updated_at_min). - get: produto por id (requer product_id). [Flattened action: get] Bulk support: accepts product_ids, category_ids for batched execution.

nuvemshop_products_get input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "q": {
      "type": "string"
    },
    "page": {
      "type": "number"
    },
    "account": {
      "type": "string"
    },
    "per_page": {
      "type": "number"
    },
    "published": {
      "type": "boolean"
    },
    "product_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        }
      ]
    },
    "category_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        }
      ]
    },
    "product_ids": {
      "type": "array",
      "items": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          }
        ]
      }
    },
    "category_ids": {
      "type": "array",
      "items": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          }
        ]
      }
    },
    "created_at_min": {
      "type": "string"
    },
    "updated_at_min": {
      "type": "string"
    }
  }
}
nuvemshop_products_get annotations
{
  "title": "nuvemshop_products_get",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
nuvemshop_products_write_create
Advertised by the server during the last successful anonymous check.

Cria ou edita produtos na Nuvemshop. Ações: - create: cria produto (data = JSON com name, variants[], etc.). - update: edita produto (requer product_id; data = JSON só com os campos a mudar). [Flattened action: create] Bulk support: accepts product_ids for batched execution.

nuvemshop_products_write_create input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "data"
  ],
  "properties": {
    "data": {
      "type": "string"
    },
    "account": {
      "type": "string"
    },
    "product_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        }
      ]
    },
    "product_ids": {
      "type": "array",
      "items": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          }
        ]
      }
    }
  }
}
nuvemshop_products_write_create annotations
{
  "title": "nuvemshop_products_write_create",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
nuvemshop_products_write_update
Advertised by the server during the last successful anonymous check.

Cria ou edita produtos na Nuvemshop. Ações: - create: cria produto (data = JSON com name, variants[], etc.). - update: edita produto (requer product_id; data = JSON só com os campos a mudar). [Flattened action: update] Bulk support: accepts product_ids for batched execution.

nuvemshop_products_write_update input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "data"
  ],
  "properties": {
    "data": {
      "type": "string"
    },
    "account": {
      "type": "string"
    },
    "product_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        }
      ]
    },
    "product_ids": {
      "type": "array",
      "items": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          }
        ]
      }
    }
  }
}
nuvemshop_products_write_update annotations
{
  "title": "nuvemshop_products_write_update",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
nuvemshop_orders_list
Advertised by the server during the last successful anonymous check.
Advertised read-only

Leitura de pedidos da loja Nuvemshop. Ações: - list: pedidos paginados (params: page, per_page, status, payment_status, shipping_status, created_at_min, updated_at_min, q). - get: pedido por id (requer order_id). [Flattened action: list] Bulk support: accepts order_ids for batched execution.

nuvemshop_orders_list input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "q": {
      "type": "string"
    },
    "page": {
      "type": "number"
    },
    "status": {
      "type": "string"
    },
    "account": {
      "type": "string"
    },
    "order_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        }
      ]
    },
    "per_page": {
      "type": "number"
    },
    "order_ids": {
      "type": "array",
      "items": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          }
        ]
      }
    },
    "created_at_min": {
      "type": "string"
    },
    "payment_status": {
      "type": "string"
    },
    "updated_at_min": {
      "type": "string"
    },
    "shipping_status": {
      "type": "string"
    }
  }
}
nuvemshop_orders_list annotations
{
  "title": "nuvemshop_orders_list",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
nuvemshop_orders_get
Advertised by the server during the last successful anonymous check.
Advertised read-only

Leitura de pedidos da loja Nuvemshop. Ações: - list: pedidos paginados (params: page, per_page, status, payment_status, shipping_status, created_at_min, updated_at_min, q). - get: pedido por id (requer order_id). [Flattened action: get] Bulk support: accepts order_ids for batched execution.

nuvemshop_orders_get input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "q": {
      "type": "string"
    },
    "page": {
      "type": "number"
    },
    "status": {
      "type": "string"
    },
    "account": {
      "type": "string"
    },
    "order_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        }
      ]
    },
    "per_page": {
      "type": "number"
    },
    "order_ids": {
      "type": "array",
      "items": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          }
        ]
      }
    },
    "created_at_min": {
      "type": "string"
    },
    "payment_status": {
      "type": "string"
    },
    "updated_at_min": {
      "type": "string"
    },
    "shipping_status": {
      "type": "string"
    }
  }
}
nuvemshop_orders_get annotations
{
  "title": "nuvemshop_orders_get",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
nuvemshop_orders_write_update
Advertised by the server during the last successful anonymous check.

Mutações em pedidos Nuvemshop. Ações: - update: PUT no pedido (requer order_id; data = JSON com campos editáveis, ex. owner_note). - close | open | cancel | pack | fulfill: transição de status (requer order_id; data opcional, ex. cancel aceita { reason }). [Flattened action: update] Bulk support: accepts order_ids for batched execution.

nuvemshop_orders_write_update input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "order_id"
  ],
  "properties": {
    "data": {
      "type": "string"
    },
    "account": {
      "type": "string"
    },
    "order_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        }
      ]
    },
    "order_ids": {
      "type": "array",
      "items": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          }
        ]
      }
    }
  }
}
nuvemshop_orders_write_update annotations
{
  "title": "nuvemshop_orders_write_update",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
nuvemshop_orders_write_close
Advertised by the server during the last successful anonymous check.

Mutações em pedidos Nuvemshop. Ações: - update: PUT no pedido (requer order_id; data = JSON com campos editáveis, ex. owner_note). - close | open | cancel | pack | fulfill: transição de status (requer order_id; data opcional, ex. cancel aceita { reason }). [Flattened action: close] Bulk support: accepts order_ids for batched execution.

nuvemshop_orders_write_close input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "order_id"
  ],
  "properties": {
    "data": {
      "type": "string"
    },
    "account": {
      "type": "string"
    },
    "order_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        }
      ]
    },
    "order_ids": {
      "type": "array",
      "items": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          }
        ]
      }
    }
  }
}
nuvemshop_orders_write_close annotations
{
  "title": "nuvemshop_orders_write_close",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
nuvemshop_orders_write_open
Advertised by the server during the last successful anonymous check.

Mutações em pedidos Nuvemshop. Ações: - update: PUT no pedido (requer order_id; data = JSON com campos editáveis, ex. owner_note). - close | open | cancel | pack | fulfill: transição de status (requer order_id; data opcional, ex. cancel aceita { reason }). [Flattened action: open] Bulk support: accepts order_ids for batched execution.

nuvemshop_orders_write_open input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "order_id"
  ],
  "properties": {
    "data": {
      "type": "string"
    },
    "account": {
      "type": "string"
    },
    "order_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        }
      ]
    },
    "order_ids": {
      "type": "array",
      "items": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          }
        ]
      }
    }
  }
}
nuvemshop_orders_write_open annotations
{
  "title": "nuvemshop_orders_write_open",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
nuvemshop_orders_write_cancel
Advertised by the server during the last successful anonymous check.

Mutações em pedidos Nuvemshop. Ações: - update: PUT no pedido (requer order_id; data = JSON com campos editáveis, ex. owner_note). - close | open | cancel | pack | fulfill: transição de status (requer order_id; data opcional, ex. cancel aceita { reason }). [Flattened action: cancel] Bulk support: accepts order_ids for batched execution.

nuvemshop_orders_write_cancel input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "order_id"
  ],
  "properties": {
    "data": {
      "type": "string"
    },
    "account": {
      "type": "string"
    },
    "order_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        }
      ]
    },
    "order_ids": {
      "type": "array",
      "items": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          }
        ]
      }
    }
  }
}
nuvemshop_orders_write_cancel annotations
{
  "title": "nuvemshop_orders_write_cancel",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
nuvemshop_orders_write_pack
Advertised by the server during the last successful anonymous check.

Mutações em pedidos Nuvemshop. Ações: - update: PUT no pedido (requer order_id; data = JSON com campos editáveis, ex. owner_note). - close | open | cancel | pack | fulfill: transição de status (requer order_id; data opcional, ex. cancel aceita { reason }). [Flattened action: pack] Bulk support: accepts order_ids for batched execution.

nuvemshop_orders_write_pack input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "order_id"
  ],
  "properties": {
    "data": {
      "type": "string"
    },
    "account": {
      "type": "string"
    },
    "order_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        }
      ]
    },
    "order_ids": {
      "type": "array",
      "items": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          }
        ]
      }
    }
  }
}
nuvemshop_orders_write_pack annotations
{
  "title": "nuvemshop_orders_write_pack",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
nuvemshop_orders_write_fulfill
Advertised by the server during the last successful anonymous check.

Mutações em pedidos Nuvemshop. Ações: - update: PUT no pedido (requer order_id; data = JSON com campos editáveis, ex. owner_note). - close | open | cancel | pack | fulfill: transição de status (requer order_id; data opcional, ex. cancel aceita { reason }). [Flattened action: fulfill] Bulk support: accepts order_ids for batched execution.

nuvemshop_orders_write_fulfill input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "order_id"
  ],
  "properties": {
    "data": {
      "type": "string"
    },
    "account": {
      "type": "string"
    },
    "order_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        }
      ]
    },
    "order_ids": {
      "type": "array",
      "items": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          }
        ]
      }
    }
  }
}
nuvemshop_orders_write_fulfill annotations
{
  "title": "nuvemshop_orders_write_fulfill",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
nuvemshop_customers_list
Advertised by the server during the last successful anonymous check.
Advertised read-only

Leitura de clientes da loja Nuvemshop. Ações: - list: clientes paginados (params: page, per_page, q, created_at_min, updated_at_min). - get: cliente por id (requer customer_id). [Flattened action: list] Bulk support: accepts customer_ids for batched execution.

nuvemshop_customers_list input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "q": {
      "type": "string"
    },
    "page": {
      "type": "number"
    },
    "account": {
      "type": "string"
    },
    "per_page": {
      "type": "number"
    },
    "customer_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        }
      ]
    },
    "customer_ids": {
      "type": "array",
      "items": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          }
        ]
      }
    },
    "created_at_min": {
      "type": "string"
    },
    "updated_at_min": {
      "type": "string"
    }
  }
}
nuvemshop_customers_list annotations
{
  "title": "nuvemshop_customers_list",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
nuvemshop_customers_get
Advertised by the server during the last successful anonymous check.
Advertised read-only

Leitura de clientes da loja Nuvemshop. Ações: - list: clientes paginados (params: page, per_page, q, created_at_min, updated_at_min). - get: cliente por id (requer customer_id). [Flattened action: get] Bulk support: accepts customer_ids for batched execution.

nuvemshop_customers_get input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "q": {
      "type": "string"
    },
    "page": {
      "type": "number"
    },
    "account": {
      "type": "string"
    },
    "per_page": {
      "type": "number"
    },
    "customer_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        }
      ]
    },
    "customer_ids": {
      "type": "array",
      "items": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          }
        ]
      }
    },
    "created_at_min": {
      "type": "string"
    },
    "updated_at_min": {
      "type": "string"
    }
  }
}
nuvemshop_customers_get annotations
{
  "title": "nuvemshop_customers_get",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
nuvemshop_categories
Advertised by the server during the last successful anonymous check.
Advertised read-only

Lista categorias da loja Nuvemshop (params opcionais: page, per_page, parent).

nuvemshop_categories input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "page": {
      "type": "number"
    },
    "parent": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        }
      ]
    },
    "account": {
      "type": "string"
    },
    "per_page": {
      "type": "number"
    }
  }
}
nuvemshop_categories annotations
{
  "title": "nuvemshop_categories",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
nuvemshop_coupons
Advertised by the server during the last successful anonymous check.
Advertised read-only

Lista cupons de desconto da loja Nuvemshop (params opcionais: page, per_page).

nuvemshop_coupons input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "page": {
      "type": "number"
    },
    "account": {
      "type": "string"
    },
    "per_page": {
      "type": "number"
    }
  }
}
nuvemshop_coupons annotations
{
  "title": "nuvemshop_coupons",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
nuvemshop_coupons_write_create
Advertised by the server during the last successful anonymous check.

Cria cupom de desconto na Nuvemshop. action: create. data = JSON com code, type (percentage|absolute|shipping), value, etc. [Flattened action: create]

nuvemshop_coupons_write_create input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "data"
  ],
  "properties": {
    "data": {
      "type": "string"
    },
    "account": {
      "type": "string"
    }
  }
}
nuvemshop_coupons_write_create annotations
{
  "title": "nuvemshop_coupons_write_create",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
show_version
Advertised by the server during the last successful anonymous check.
Advertised read-only

Show the current MCP platform and adapter versions.

show_version input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}
show_version annotations
{
  "title": "Show Version",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
report_bug
Advertised by the server during the last successful anonymous check.

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

report_bug input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "message"
  ],
  "properties": {
    "context": {
      "type": "string",
      "default": ""
    },
    "message": {
      "type": "string"
    },
    "conversation": {
      "type": "string",
      "default": "[]"
    }
  }
}
report_bug annotations
{
  "title": "Report Bug",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
connect
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

connect input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}
connect annotations
{
  "title": "Connection Status",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
toolkit_info
Advertised by the server during the last successful anonymous check.
Advertised read-only

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

toolkit_info input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}
toolkit_info annotations
{
  "title": "Toolkit Info",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
marketplace
Advertised by the server during the last successful anonymous check.
Open-world

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.

marketplace input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "limit": {
      "type": "number",
      "default": 10
    },
    "query": {
      "type": "string",
      "default": ""
    },
    "action": {
      "enum": [
        "search",
        "describe",
        "install",
        "uninstall",
        "subscribe",
        "cancel",
        "resume",
        "report_bug",
        "request_mcp",
        "list_tools",
        "invoke",
        "search_prompts",
        "get_prompt",
        "publish_prompt"
      ],
      "type": "string",
      "default": "search"
    },
    "mcp_id": {
      "type": "string",
      "default": ""
    },
    "message": {
      "type": "string",
      "default": ""
    },
    "tool_id": {
      "type": "string",
      "default": ""
    },
    "arguments": {
      "type": "string",
      "default": "{}"
    },
    "immediate": {
      "type": "boolean",
      "default": false
    },
    "tier_slug": {
      "type": "string",
      "default": ""
    },
    "prompt_body": {
      "type": "string",
      "default": ""
    },
    "prompt_slug": {
      "type": "string",
      "default": ""
    },
    "prompt_tool": {
      "type": "string",
      "default": ""
    },
    "prompt_vars": {
      "type": "string",
      "default": "{}"
    },
    "conversation": {
      "type": "string",
      "default": "[]"
    },
    "prompt_title": {
      "type": "string",
      "default": ""
    },
    "request_name": {
      "type": "string",
      "default": ""
    },
    "cancel_reason": {
      "enum": [
        "too_expensive",
        "missing_features",
        "switched_service",
        "unused",
        "customer_service",
        "too_complex",
        "low_quality",
        "other"
      ],
      "type": "string"
    },
    "cancel_comment": {
      "type": "string",
      "default": ""
    },
    "prompt_targets": {
      "type": "array",
      "items": {
        "enum": [
          "claude",
          "chatgpt",
          "cursor",
          "lovable"
        ],
        "type": "string"
      },
      "default": []
    },
    "report_context": {
      "type": "string",
      "default": ""
    },
    "prompt_category": {
      "type": "string",
      "default": ""
    },
    "request_details": {
      "type": "string",
      "default": ""
    },
    "prompt_description": {
      "type": "string",
      "default": ""
    }
  }
}
marketplace annotations
{
  "title": "Marketplace",
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}
authenticate
Advertised by the server during the last successful anonymous check.

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.

authenticate input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "token": {
      "type": "string"
    }
  }
}
authenticate annotations
{
  "title": "Authenticate",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

Prompts

Not advertised

No prompt definitions available.

Resources

Not advertised

No resource definitions available.

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks
1 of 1 (100%)
Average latency
769 ms
95th percentile latency
769 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

  • · probe · passed · 769 ms · metadata changed · 24 tool(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http nuvemshop-mcp https://api.mcp.ai/p_nuvemshop

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add nuvemshop-mcp --url https://api.mcp.ai/p_nuvemshop

Cursor

Merge this server into .cursor/mcp.json in your project, then enable nuvemshop-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "nuvemshop-mcp": {
      "url": "https://api.mcp.ai/p_nuvemshop"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "nuvemshop-mcp": {
      "type": "streamableHttp",
      "url": "https://api.mcp.ai/p_nuvemshop",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start nuvemshop-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "nuvemshop-mcp": {
      "type": "http",
      "url": "https://api.mcp.ai/p_nuvemshop"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http nuvemshop-mcp https://api.mcp.ai/p_nuvemshop

Claude Desktop

Open Claude Settings > Connectors > Add custom connector, enter this server URL and enable it for the conversation. This is a manual remote-connector handoff, not a desktop JSON configuration.
Claude Desktop configuration
https://api.mcp.ai/p_nuvemshop

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "nuvemshop-mcp": {
      "serverUrl": "https://api.mcp.ai/p_nuvemshop"
    }
  }
}

Let your agent find its tools

Find servers like mcp-dir Nuvemshop MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.