IPRoyal (Proxy Services) MCP Server for LlamaIndex 10 tools — connect in under 2 minutes
LlamaIndex specializes in data-aware AI agents that connect LLMs to structured and unstructured sources. Add IPRoyal (Proxy Services) as an MCP tool provider through Vinkius and your agents can query, analyze, and act on live data alongside your existing indexes.
ASK AI ABOUT THIS MCP SERVER
Vinkius supports streamable HTTP and SSE.
import asyncio
from llama_index.tools.mcp import BasicMCPClient, McpToolSpec
from llama_index.core.agent.workflow import FunctionAgent
from llama_index.llms.openai import OpenAI
async def main():
# Your Vinkius token. get it at cloud.vinkius.com
mcp_client = BasicMCPClient("https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")
mcp_tool_spec = McpToolSpec(client=mcp_client)
tools = await mcp_tool_spec.to_tool_list_async()
agent = FunctionAgent(
tools=tools,
llm=OpenAI(model="gpt-4o"),
system_prompt=(
"You are an assistant with access to IPRoyal (Proxy Services). "
"You have 10 tools available."
),
)
response = await agent.run(
"What tools are available in IPRoyal (Proxy Services)?"
)
print(response)
asyncio.run(main())
* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
About IPRoyal (Proxy Services) MCP Server
Connect your IPRoyal account to any AI agent and take full control of your global proxy infrastructure and web scraping operations through natural conversation.
LlamaIndex agents combine IPRoyal (Proxy Services) tool responses with indexed documents for comprehensive, grounded answers. Connect 10 tools through Vinkius and query live data alongside vector stores and SQL databases in a single turn. ideal for hybrid search, data enrichment, and analytical workflows.
What you can do
- Account Audit — Check your account balance and profile details directly from your agent to ensure sufficient funds for large scraping runs
- Traffic Monitoring — Retrieve precise bandwidth consumption statistics for your residential and datacenter proxy orders in real-time
- Credential Rotation — Instantly update usernames and passwords for specific proxy orders to maintain security hygiene and access control
- Geo-Targeting Intelligence — Check proxy IP availability across different countries and retrieve supported country codes for precise geographic targeting
- Whitelist Management — Authorize and revoke client IP addresses for user/pass-free access, securing your headless scrapers and servers
- Proxy Orchestration — Generate dynamic geo-targeted connection strings with support for sticky sessions and specific country routing
The IPRoyal (Proxy Services) MCP Server exposes 10 tools through the Vinkius. Connect it to LlamaIndex in under two minutes — no API keys to rotate, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
How to Connect IPRoyal (Proxy Services) to LlamaIndex via MCP
Follow these steps to integrate the IPRoyal (Proxy Services) MCP Server with LlamaIndex.
Install dependencies
Run pip install llama-index-tools-mcp llama-index-llms-openai
Replace the token
Replace [YOUR_TOKEN_HERE] with your Vinkius token
Run the agent
Save to agent.py and run: python agent.py
Explore tools
The agent discovers 10 tools from IPRoyal (Proxy Services)
Why Use LlamaIndex with the IPRoyal (Proxy Services) MCP Server
LlamaIndex provides unique advantages when paired with IPRoyal (Proxy Services) through the Model Context Protocol.
Data-first architecture: LlamaIndex agents combine IPRoyal (Proxy Services) tool responses with indexed documents for comprehensive, grounded answers
Query pipeline framework lets you chain IPRoyal (Proxy Services) tool calls with transformations, filters, and re-rankers in a typed pipeline
Multi-source reasoning: agents can query IPRoyal (Proxy Services), a vector store, and a SQL database in a single turn and synthesize results
Observability integrations show exactly what IPRoyal (Proxy Services) tools were called, what data was returned, and how it influenced the final answer
IPRoyal (Proxy Services) + LlamaIndex Use Cases
Practical scenarios where LlamaIndex combined with the IPRoyal (Proxy Services) MCP Server delivers measurable value.
Hybrid search: combine IPRoyal (Proxy Services) real-time data with embedded document indexes for answers that are both current and comprehensive
Data enrichment: query IPRoyal (Proxy Services) to augment indexed data with live information before generating user-facing responses
Knowledge base agents: build agents that maintain and update knowledge bases by periodically querying IPRoyal (Proxy Services) for fresh data
Analytical workflows: chain IPRoyal (Proxy Services) queries with LlamaIndex's data connectors to build multi-source analytical reports
IPRoyal (Proxy Services) MCP Tools for LlamaIndex (10)
These 10 tools become available when you connect IPRoyal (Proxy Services) to LlamaIndex via MCP:
add_whitelist_ip
This is highly recommended for securely authenticating headless scrapers or servers where you do not want to expose proxy credentials in source code. Authorize a new IP for IPRoyal proxy access
change_credentials
If you suspect your proxy credentials have leaked or you need to rotate access keys for security, use this tool to set a new username and password instantly. Update username/password for an IPRoyal proxy order
generate_proxy_string
Standard format is `geo.iproyal.com:10000:username:password`. Pass `country` to append geographic targeting rules, or `session` for sticky IP sessions. Helper to generate a dynamic geo-targeted proxy string
get_availability
Useful to dynamically determine if a target region has sufficient IPs before initiating a geo-targeted crawl. By default targets "residential". Check proxy IP availability across different countries
get_profile
Use this to ensure there are enough funds before executing large scraping runs. Get IPRoyal account balance and profile details
get_traffic
Residential proxies are billed by traffic, so regular monitoring with this endpoint prevents unexpected depletion of funds. Get precise proxy traffic consumption statistics for an order
list_countries
Contains the specific country codes (e.g., "us", "de") and region identifiers required to construct geo-targeted proxy connection strings (e.g., appending "_country-us" to the password). Get list of supported geo-targeting countries, cities, and ISPs
list_orders
An order represents a purchased batch of proxy traffic or IPs (e.g., Royal Residential, Sneaker IPs). The response contains order IDs necessary for traffic lookups and credential management. Get all active proxy orders (Residential, Datacenter)
list_whitelisted_ips
Whitelisted IPs can connect directly to the proxy endpoints without supplying the username and password in the connection string. List IPs allowed to connect to IPRoyal without user/pass
remove_whitelist_ip
Required for security hygiene when scraping servers are decommissioned or IP addresses change. Revoke an IP from IPRoyal proxy access
Example Prompts for IPRoyal (Proxy Services) in LlamaIndex
Ready-to-use prompts you can give your LlamaIndex agent to start working with IPRoyal (Proxy Services) immediately.
"Check my IPRoyal account balance"
"How much traffic have I used for order ID '123456'?"
"Generate a proxy connection string for Germany with sticky session"
Troubleshooting IPRoyal (Proxy Services) MCP Server with LlamaIndex
Common issues when connecting IPRoyal (Proxy Services) to LlamaIndex through the Vinkius, and how to resolve them.
BasicMCPClient not found
pip install llama-index-tools-mcpIPRoyal (Proxy Services) + LlamaIndex FAQ
Common questions about integrating IPRoyal (Proxy Services) MCP Server with LlamaIndex.
How does LlamaIndex connect to MCP servers?
Can I combine MCP tools with vector stores?
Does LlamaIndex support async MCP calls?
Connect IPRoyal (Proxy Services) with your favorite client
Step-by-step setup guides for every MCP-compatible client and framework:
Anthropic's native desktop app for Claude with built-in MCP support.
AI-first code editor with integrated LLM-powered coding assistance.
GitHub Copilot in VS Code with Agent mode and MCP support.
Purpose-built IDE for agentic AI coding workflows.
Autonomous AI coding agent that runs inside VS Code.
Anthropic's agentic CLI for terminal-first development.
Python SDK for building production-grade OpenAI agent workflows.
Google's framework for building production AI agents.
Type-safe agent development for Python with first-class MCP support.
TypeScript toolkit for building AI-powered web applications.
TypeScript-native agent framework for modern web stacks.
Python framework for orchestrating collaborative AI agent crews.
Leading Python framework for composable LLM applications.
Data-aware AI agent framework for structured and unstructured sources.
Microsoft's framework for multi-agent collaborative conversations.
Connect IPRoyal (Proxy Services) to LlamaIndex
Get your token, paste the configuration, and start using 10 tools in under 2 minutes. No API key management needed.