How to Use the Gift Up! MCP in LlamaIndex

Q: How do I set up Gift Up! with LlamaIndex?

Install the llama-index-tools-mcp adapter and connect to the MCP Server. You convert the tools into an McpToolSpec and pass them to your LlamaIndex FunctionAgent.

Q: Can LlamaIndex search through my historical Gift Up! orders?

Yes, the agent uses listgiftorders to fetch your order history. It indexes these records into a vector store, allowing semantic searches across past transactions.

Q: How does LlamaIndex verify that a Gift Up! gift card is valid?

The agent calls validategiftcard with the card code. This live check returns the active balance and expiration date, grounding the agent's response in real API data.

Q: Can I filter which tools my LlamaIndex agent can access?

Yes, you use the allowedtools filter during setup to restrict the LlamaIndex agent. For example, you can allow card lookups while blocking redemption tools.

Index active gift card balances and order histories directly into your LlamaIndex knowledge base via 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 Gift Up! MCP to LlamaIndex

Create your Vinkius account to connect Gift Up! 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 Gift Up! with LlamaIndex

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Index active Gift Up! card balances for LlamaIndex

`list_active_gift_cards` pulls your entire active Gift Up! card register directly into LlamaIndex using this MCP Server. The agent converts this live balance data into vector embeddings, making card metadata searchable in real time. When customers ask support about their Gift Up! balances, your LlamaIndex agent queries the index instead of making repeated API calls. This reduces API rate limit usage while providing instant, grounded answers.

Query order metadata using LlamaIndex tools

`list_gift_orders` retrieves your historical Gift Up! order data to build a queryable ledger inside LlamaIndex. The agent indexes these records, linking transaction references to specific customer profiles. You search this LlamaIndex index using natural language to resolve Gift Up! purchase disputes. The agent reads `get_order_details` to verify transaction dates and amounts, eliminating manual database lookups.

Ground your support agent's answers in live API data

`validate_gift_card` checks the exact current balance of any Gift Up! card reference inside your LlamaIndex pipeline. Your agent runs this tool synchronously during customer chats to verify funds before suggesting products. This live validation prevents the LlamaIndex agent from hallucinating Gift Up! balances or using outdated cached data. The agent uses `get_card_details` to pull metadata, ensuring the card is active and valid.

Setup guide

Set up Gift Up! 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 Gift Up! 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 Gift Up! tools.",
)
response = await agent.run("List recent Gift Up! 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 Gift Up!. 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 Gift Up! 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 Gift Up! MCP in LlamaIndex

Install the `llama-index-tools-mcp` adapter and connect to the MCP Server. You convert the tools into an `McpToolSpec` and pass them to your LlamaIndex `FunctionAgent`.

Yes, the agent uses `list_gift_orders` to fetch your order history. It indexes these records into a vector store, allowing semantic searches across past transactions.

The agent calls `validate_gift_card` with the card code. This live check returns the active balance and expiration date, grounding the agent's response in real API data.

Yes, you use the `allowed_tools` filter during setup to restrict the LlamaIndex agent. For example, you can allow card lookups while blocking redemption tools.

All Gift Up! order details and active card metadata processed by the MCP Server run in a zero-trust, isolated runtime. LlamaIndex only indexes the specific fields you allow, and the underlying Vinkius sandbox never persists your API keys or webhook configurations to disk.

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