How to Use the FirstPromoter MCP in LlamaIndex

Q: How do I search FirstPromoter data in LlamaIndex?

After the agent runs a tool like listpromoters, the output is ingested into your index. You can then query that index to find specific affiliate details.

Ground your LlamaIndex knowledge base in live affiliate data by indexing FirstPromoter API output for semantic search.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect FirstPromoter MCP to LlamaIndex

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Index FirstPromoter data for LlamaIndex

Turn your affiliate conversion history into searchable knowledge by indexing results from `list_conversions`. LlamaIndex stores these records so your agent can query past performance with natural language. Stop digging through dashboards. Ask your agent about specific referral trends and get answers based on your actual account data.

Query campaigns using LlamaIndex agents

Use `list_campaigns` to pull current program settings into your vector store. Your agent understands the context of your active offers and can provide insights based on historical engagement. This creates a bridge between your static documentation and live account state. Your RAG system stays current without manual updates.

Retrieve lead details with LlamaIndex

Pull specific records using `get_lead` and insert them into your knowledge graph. LlamaIndex allows your agent to synthesize this data alongside your other company documents. It makes your agent smarter by providing immediate access to granular lead info. You get a unified view of your affiliate funnel.

Setup guide

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

It does. You use the LlamaIndex MCP tool spec to turn API endpoints into functions your agent can call and index.

After the agent runs a tool like `list_promoters`, the output is ingested into your index. You can then query that index to find specific affiliate details.

The data is pulled directly from the API. Since the agent uses the tool output as ground truth, the risk of hallucination is significantly reduced.

Vinkius handles the authentication tokens and keeps the session ephemeral. Your API keys never touch the local vector store directly.

It touches lead contact info and affiliate payout records. These are processed through a memory-isolated sandbox that wipes data after the session ends.

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