How to Use the API Ninjas MCP in LlamaIndex

Q: How do I index API Ninjas exercise data in LlamaIndex?

You use McpToolSpec to load the getexercises tool into your LlamaIndex agent. The agent executes the tool, wraps the workout instructions in a document node, and writes it directly to your vector index.

Q: Can I use API Ninjas with LlamaIndex for personalized caloric RAG?

Yes, you can query getbmr and gettdee to get precise metabolic baselines. LlamaIndex indexes these baselines alongside food logs, allowing the agent to retrieve actual metabolic limits when answering diet questions.

Q: How do I configure the API Ninjas MCP Server connection in LlamaIndex?

Install llama-index-tools-mcp and initialize the BasicMCPClient with your Vinkius URL. Convert the client to tools using totoollistasync() and pass them to your FunctionAgent.

Q: Does LlamaIndex support filtering which fitness tools are exposed?

Yes, you can use the allowedtools filter when setting up the client. This lets you restrict your agent to only getnutrition or getexercises if you want to keep the agent focused on a single task.

Index live API Ninjas health data into your LlamaIndex vector store for hallucination-free RAG.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect API Ninjas MCP to LlamaIndex

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Turn live nutritional data into LlamaIndex index nodes

The `get_nutrition` tool retrieves exact macronutrient counts that your LlamaIndex pipeline indexes on the fly. Instead of relying on static PDFs or outdated food lists, your agent pulls live data and inserts it directly into your vector store. This prevents your RAG application from hallucinating calorie counts. By querying the API Ninjas MCP Server, your pipeline grounds its answers in real, verified nutritional metrics before generating a response.

Index step counts and sleep targets for contextual search

The `get_steps` and `get_sleep` tools provide the raw physical metrics your LlamaIndex agent needs to analyze daily habits. The agent queries these tools, packages the results as document nodes, and indexes them for semantic search. This lets users ask natural language questions about their progress over time. The agent searches past indexed tool outputs to find patterns, comparing actual step distances against recommended sleep ranges.

Build a semantic workout index with this MCP Server

The `get_exercises` tool lets you fetch highly specific workout instructions based on target muscles or equipment. LlamaIndex takes these step-by-step instructions and indexes them, making it easy to retrieve workouts via semantic similarity. You can combine these live API Ninjas results with your user's personal injury history documents. The agent queries both sources, ensuring the retrieved exercises match the user's physical constraints.

Setup guide

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

You use `McpToolSpec` to load the `get_exercises` tool into your LlamaIndex agent. The agent executes the tool, wraps the workout instructions in a document node, and writes it directly to your vector index.

Yes, you can query `get_bmr` and `get_tdee` to get precise metabolic baselines. LlamaIndex indexes these baselines alongside food logs, allowing the agent to retrieve actual metabolic limits when answering diet questions.

Install `llama-index-tools-mcp` and initialize the `BasicMCPClient` with your Vinkius URL. Convert the client to tools using `to_tool_list_async()` and pass them to your `FunctionAgent`.

Yes, you can use the `allowed_tools` filter when setting up the client. This lets you restrict your agent to only `get_nutrition` or `get_exercises` if you want to keep the agent focused on a single task.

All biometric data processed by the API Ninjas MCP tools runs within secure, zero-trust V8 isolates on Vinkius. Your local LlamaIndex vector store holds the indexed results, while the transit layer uses token-based encryption that prevents exposure.

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