Skip to main content

Fitrofy connector for AI assistants

Use the Fitrofy API inside Claude, Cursor, Gemini CLI and any other assistant that supports MCP (Model Context Protocol). The connector covers Indian food search, barcode, photo and label scans, and the Fitrofy diet brain: user profiles, food logging, insights, diet plans and "can I eat this?" answers.

It runs on your own computer, and calls go to Fitrofy from your computer's IP address.

Before you start

  1. Create a free account at https://apiportal.fitrofy.com. ₹500 is added to your account.
  2. Under API keys, create a key. Add this computer's public IP address to the key: every Fitrofy key accepts calls only from the addresses it lists.
  3. Install uv. The commands below use uvx to run the connector.

Add it to your assistant

Claude Desktop

Settings → Developer → Edit config, then add:

{
  "mcpServers": {
    "fitrofy": {
      "command": "uvx",
      "args": ["fitrofy-mcp"],
      "env": {
        "FITROFY_CLIENT_ID": "fit_live_all_...",
        "FITROFY_CLIENT_SECRET": "fsk_..."
      }
    }
  }
}

Claude Code

claude mcp add fitrofy -e FITROFY_CLIENT_ID=fit_live_all_... -e FITROFY_CLIENT_SECRET=fsk_... -- uvx fitrofy-mcp

Cursor

Add the same mcpServers block as Claude Desktop to ~/.cursor/mcp.json.

Gemini CLI

gemini extensions install https://github.com/Fitrofy/fitrofy-gemini-extension

Then set FITROFY_CLIENT_ID and FITROFY_CLIENT_SECRET in your shell.

Tools

Tool What it does Price (+ GST)
food_search Calories, macros and health ratings for an Indian food ₹1; ₹0.50 after 2,000 a month; no match free
scan_barcode A packaged food by its barcode ₹1; not found free
scan_food_image The foods in a photo ₹2
scan_label A nutrition label from one or two photos ₹2
register_user A user's profile and daily targets free
get_user A user's profile and targets free
log_meals Log what a user ate, in plain words ₹10 per user per date; the rest of that date free
get_day_log, get_insights, get_recommendations The logged day, its insights, next-meal advice free once that date's log is paid
get_diet_plan A user's diet plan for a date ₹1.50 per user per date
ask_food_question "Can I eat…?" or "What should I eat…?" for a user ₹1

Every paid call is charged to your Fitrofy balance. The key's hourly, daily and monthly spend caps apply, as they do to any call.

scan_food_image and scan_label also accept a file path on your computer (image_path, image_paths).

No personal data

A user is named only by user_ref, your own pseudonymous ID (for example acme-u-7f3a9c). Never put a person's name, email address or phone number in a request; Fitrofy refuses them. What you type into an AI assistant is also processed under that assistant's own terms.

Fitrofy's answers are food information, not medical advice.

Settings

Variable
FITROFY_CLIENT_ID Your key's client ID
FITROFY_CLIENT_SECRET Your key's secret
FITROFY_BASE_URL Optional; defaults to https://apiportal.fitrofy.com

If Fitrofy refuses the key, the connector stops calling until it is restarted, so a wrong secret does not lock the key.

Development

The tool list is built from the public OpenAPI (web/public/openapi/fitrofy-components.v1.yaml) and the HTTP work is the Python client (clients/python/fitrofy.py); both are copied into the wheel at build time. Test: python -m pytest clients/mcp/tests.

mcp-name: io.github.Fitrofy/fitrofy-mcp

Metadata

Release files for fitrofy-mcp 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for fitrofy-mcp 0.1.0
File Interpreter ABI Platform Actions
fitrofy_mcp-0.1.0-py3-none-any.whl Python 3 none any Details for fitrofy_mcp-0.1.0-py3-none-any.whl

Release files / fitrofy_mcp-0.1.0-py3-none-any.whl

Download URL fitrofy_mcp-0.1.0-py3-none-any.whl
Size 23.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
47bc97afaeb4e6b222e641dc83acfb7ff700e5cb3c236eb7315ab601b9a214a2
BLAKE2b-256 checksum
How to use checksums
dd109b03d0c4639bf44cceca142e2a699ca81814c3ab8a7851bde5c329fa4668
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.5

Security for fitrofy-mcp 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

1 release file No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page