# Seed Oil Tracker MCP Server

A free, hosted MCP server that gives AI assistants live access to the largest
restaurant seed oil database: 500+ US chains, 40,000+ menu items, each with an
estimated PUFA (polyunsaturated fat) value built from published nutrition data
and disclosed cooking oils.

Ask your assistant things like:
- Does Chick-fil-A use seed oils?
- What oil does Chipotle cook with?
- What is the cleanest thing to order at Five Guys?
- Which chains have the lowest seed oil overall?

## Connect

No key, no account, read only.

**Endpoint (streamable HTTP):**

```
https://seedoiltracker.com/mcp
```

**Claude (claude.ai):** Settings, then Connectors, then Add custom connector,
then paste the endpoint URL.

**Claude Code:**

```
claude mcp add --transport http seed-oil-tracker https://seedoiltracker.com/mcp
```

**Any other MCP client:** streamable HTTP transport, no auth.

Setup guide: https://seedoiltracker.com/mcp-setup

## Run locally (stdio)

Prefer a local process, or your client only speaks stdio? This repo ships a
zero-dependency stdio server (`server.py`, Python 3.8+, standard library
only). It answers the MCP handshake locally and forwards tool calls to the
hosted endpoint.

```
python server.py
```

Claude Desktop config example:

```json
{
  "mcpServers": {
    "seed-oil-tracker": {
      "command": "python",
      "args": ["/path/to/server.py"]
    }
  }
}
```

Or with Docker:

```
docker build -t seed-oil-tracker-mcp .
docker run -i seed-oil-tracker-mcp
```

## Tools

| Tool | What it does |
| --- | --- |
| `get_chain` | One chain's seed oil letter grade, the oil it fries in, the cleanest menu items to order, and the highest to avoid. Fuzzy name matching. |
| `search_chains` | Find covered chains by full or partial name. |
| `get_rankings` | Chains ranked cleanest first or worst first by average seed oil per menu item. |

## Data

Same dataset that powers the Seed Oil Tracker iOS app and seedoiltracker.com.
Also available as a no-key JSON API and ChatGPT Action
(https://seedoiltracker.com/ai-tool) and as an open dataset in CSV and JSON,
licensed CC BY 4.0 (https://seedoiltracker.com/open-data).

Methodology and citation: https://seedoiltracker.com/methodology

## About

Built by Seed Oil Tracker (https://seedoiltracker.com). The hosted server is
the primary way to connect; this repository documents it and ships the local
stdio bridge. Questions and issues welcome here.