fatsecret Platform API Documentation

MCP Server

Overview

The fatsecret Platform MCP Server uses the Model Context Protocol (MCP), a standardized way for AI assistants to speak directly to the fatsecret Platform API. Users can search for foods, look up barcodes and get detailed food nutrition data by simply asking their compatible AI assistant, including Anthropic's Claude and OpenAI's ChatGPT.

The fatsecret Platform MCP Server is available for Premier and Premier Free accounts, and runs on top of your existing Platform API account. Permissions and call limits are inherited from the API key and shared by every team member's MCP seat.

What are the benefits

Connecting to the fatsecret Platform MCP Server gives your AI assistant direct access to tools that use the Platform API.

TOOL WHAT IT DOES EXAMPLE
Food Search Searches foods based on a search expression and returns matching food_ids with servings and nutrition. "Search for 3 types of bananas and compare protein"
Individual Food Lookup Returns standard servings and full nutrition for a food_id. "Find Greek yogurt and tell me the protein per 100 g"
Barcode Lookup Finds a packaged food by its GTIN-13 barcode. "Find the food for barcode 0016000176829"
Account Capabilities Lists the tools, data editions and regions available to the signed-in seat. "Show me what tools I can use on my account"
Requirements

For the account holder:

  • A Premier or Premier Free fatsecret Platform API account, with an active API key.
  • MCP enabled on your API key. If the MCP Seat Allocation page in your account shows "MCP Team Seats aren't enabled for this API key yet", contact us to request access.
  • An MCP seat for each team member (see MCP seats below).

For each team member:

  • An invitation email from the account holder to an MCP seat.
  • Your own secure password, chosen using the one-time link in the invitation email.
  • An MCP-compatible AI assistant, such as Claude.
  • The fatsecret Platform MCP Server added to your AI assistant (see Connecting below), signed in with your MCP seat email and password.
Getting started
MCP Team Seats

MCP Seats are managed by the account holder from MCP Seat Allocation in the account menu, or the MCP Team Seats tile on the Dashboard. Every Premier and Premier Free account includes 5 MCP seats by default. To add more, use the Contact Us form.

To invite a team member:

  1. Go to MCP Seat Allocation.
  2. Enter the team member's email address and, optionally, their name.
  3. Select Send invite. They receive an email with a one-time link (valid for 24 hours) to choose their own secure password.
Seat statuses and actions
STATUS MEANING AVAILABLE ACTIONS
Pending Invited; password not yet set Resend, Delete
Expired The 24-hour invite link has expired Resend, Delete
Accepted Active seat Disable, Reset password, Delete
Disabled Temporarily suspended by the account holder Enable, Reset password, Delete
Reset pending A password reset was sent; the seat is suspended until a new password is set Resend reset link, Delete

A seat in Reset pending cannot be re-enabled directly, because that would restore the old password the reset was meant to replace.

Additional information
  • Disabling or deleting a seat revokes that person's access within 5 minutes.
  • Deleted seats don't count toward your seat limit. When all seats are in use, invites are blocked until you delete a seat or request more.
  • Team members can't reset their own password. They should ask the account holder to send a reset link from the Platform API Account Dashboard.
  • Every request is attributed to the seat that made it.
Connecting

Add the server manually using the server URL https://mcp.fatsecret.com. No API token is required – your AI assistant will prompt you to sign in with your MCP seat email and password on first use.

  1. Go to Settings → Connectors → Add custom connector and paste https://mcp.fatsecret.com.
  2. Select Connect. Claude opens the fatsecret sign-in page.
  3. Sign in with your MCP seat email and password, then approve the requested access.
  4. Claude returns to the conversation with the fatsecret connector enabled and its read-only tools available.

Run this command, then sign in with your MCP seat email and password when prompted:

claude mcp add --transport http fatsecret https://mcp.fatsecret.com
  1. Go to Settings → Connectors → Create. Creating a custom connector requires developer mode to be enabled.
  2. Paste https://mcp.fatsecret.com, choose OAuth, then sign in with your MCP seat email and password.
  3. Enable fatsecret in a new conversation and start asking.

Run these commands, then sign in with your MCP seat email and password in the browser window that opens:

codex mcp add fatsecret --url https://mcp.fatsecret.com
codex mcp login fatsecret

Add this to ~/.cursor/mcp.json (or .cursor/mcp.json in your project), then restart Cursor and sign in when prompted:

{
  "mcpServers": {
    "fatsecret": {
      "url": "https://mcp.fatsecret.com"
    }
  }
}

Add this to your mcp.json, then sign in when prompted:

{
  "servers": {
    "fatsecret-mcp": {
      "type": "http",
      "url": "https://mcp.fatsecret.com"
    }
  }
}
Permissions, limits and regions

An MCP seat inherits the permissions of the API key it belongs to:

  • Call limits: Requests made through the fatsecret Platform MCP Server count toward your API key's existing call limits.
  • Regions: Only the regions enabled for your key are available. If no region is specified, results come from the US database. Ask the assistant to use another enabled region by name, for example "Search for Vegemite in the Australian database".
  • Data editions: Premier data (such as default servings, food images, allergens, dietary preferences, food classification or nutrient content tags), barcode and localization capabilities are only returned if your key includes them.
  • API methods: The MCP Server currently uses the latest foods.search.v6, food.get.v6 and food.find_id_for_barcode.v3 methods.

Ask the assistant "What can my fatsecret account access?" at any time to see the editions and regions available to your seat.

Troubleshooting

Why do I see "Invalid email or password" when signing in?

Check the email and password. The same message is shown for a wrong password, an unknown email or a suspended seat. Repeated failed attempts lock the seat; ask the account holder to send a password reset. Disabling and re-enabling the seat won't clear a lock.

What do I do if my invite or reset link has expired?

Invite and reset links are valid for 24 hours. Ask the account holder to resend the link.

What if I see "Region not available"?

The region isn't enabled for your API key. Prompt your AI agent to "Show me what tools I can use on my account" to see enabled regions, or contact us to add regions.

What if I see "Barcode not found"?

The barcode isn't in the database yet. Ask the assistant to search by product name instead.

What if sign-in fails or my session expires?

Disconnect and reconnect the fatsecret Platform MCP Server in your AI assistant. If the problem continues, contact us.

Limitations