How to Use the Nuvemshop MCP in LlamaIndex

Q: How do I index my Nuvemshop catalog into a LlamaIndex vector store?

You use the LlamaIndex MCP tool spec to fetch items via listproducts and load them into a LlamaIndex Document object. From there, LlamaIndex handles the embedding generation for your Nuvemshop products.

Index your Nuvemshop catalog and store data directly into LlamaIndex vector stores using this MCP Server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Nuvemshop MCP to LlamaIndex

Create your Vinkius account to connect Nuvemshop to LlamaIndex and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Nuvemshop with LlamaIndex

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Turn e-commerce data into a queryable index

The `list_products` tool fetches your entire Nuvemshop catalog so LlamaIndex can transform the raw product data into searchable vector embeddings. This allows your LlamaIndex agent to answer complex customer queries by searching through Nuvemshop descriptions and SKUs semantically. Instead of relying on exact keyword matches, your LlamaIndex search pipeline finds relevant Nuvemshop items based on intent. Our integration combines live Nuvemshop API data with your existing documentation to provide accurate, grounded answers in LlamaIndex.

Synthesize customer profiles for RAG pipelines

The `get_customer` tool retrieves detailed Nuvemshop buyer profiles, including past purchase history and total spend, directly into LlamaIndex. LlamaIndex indexes these profiles to help your support agent quickly find Nuvemshop context during live conversations. By grounding the LlamaIndex agent's responses in actual Nuvemshop transaction records, you prevent hallucinations about order statuses. Your query engine pulls the exact Nuvemshop customer record and merges it with your prompt template on the fly.

Query Nuvemshop MCP Server resources semantically

The `list_orders` tool provides a feed of recent Nuvemshop transactions that LlamaIndex can parse and index for business intelligence. You can ask your LlamaIndex agent to find trends in your Nuvemshop sales data without writing SQL queries. Because the LlamaIndex framework supports resource loading, the agent can pull the full context of any Nuvemshop order when answering. This turns your raw Nuvemshop transactional data into a dynamic knowledge base for your LlamaIndex application.

Setup guide

Set up Nuvemshop MCP in LlamaIndex

Prerequisites

Python 3.10+ installed
llama-index-tools-mcp package
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run pip install llama-index-tools-mcp llama-index-llms-openai. The MCP tools package provides BasicMCPClient and McpToolSpec.
2

Connect with BasicMCPClient
Point BasicMCPClient to your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. Supports SSE and Streamable HTTP transports.
3

Convert to LlamaIndex tools
Call mcp_tool_spec.to_tool_list_async() to convert all Nuvemshop MCP tools into native FunctionTool objects that any LlamaIndex agent can use.
4

Run with any LLM
Create a FunctionAgent with the tools and your preferred LLM. Swap OpenAI for Anthropic, Gemini, or any LlamaIndex-supported provider.

agent.py

from llama_index.tools.mcp import BasicMCPClient, McpToolSpec
from llama_index.core.agent.workflow import FunctionAgent
from llama_index.llms.openai import OpenAI

# Connect to the MCP
mcp_client = BasicMCPClient(
    "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
)
mcp_tool_spec = McpToolSpec(client=mcp_client)

# Convert MCP tools to LlamaIndex tools
tools = await mcp_tool_spec.to_tool_list_async()

# Create and run the agent
agent = FunctionAgent(
    tools=tools,
    llm=OpenAI(model="gpt-4o"),
    system_prompt="You have access to Nuvemshop tools.",
)
response = await agent.run("List recent Nuvemshop data")

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Nuvemshop. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Nuvemshop now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Nuvemshop MCP in LlamaIndex

You use the LlamaIndex MCP tool spec to fetch items via `list_products` and load them into a LlamaIndex Document object. From there, LlamaIndex handles the embedding generation for your Nuvemshop products.

Yes, if a query requires an action, the LlamaIndex agent can invoke `update_product` to modify Nuvemshop stock levels directly. This lets you build active LlamaIndex search agents that don't just find information but also update your Nuvemshop store.

The server outputs clean JSON schemas for Nuvemshop tools like `get_coupon`, which the LlamaIndex framework converts into structured metadata. This makes it easy to filter LlamaIndex search results by Nuvemshop coupon type or validity dates.

You certainly can, by combining Nuvemshop customer data from `list_customers` with order details from `list_orders` into a unified LlamaIndex query engine. This gives your LlamaIndex support bot the exact context needed to resolve Nuvemshop shipping and order queries.

Your Nuvemshop e-commerce tokens, customer emails, and financial totals accessed via `list_customers` never touch public LlamaIndex vector indexes. Vinkius runs the Nuvemshop server in an isolated V8 sandbox, ensuring that sensitive transaction details are processed ephemerally and never cached externally during LlamaIndex runs.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript