Skip to main content
Glama
JourneyFoodsDev

Journey AI MCP Server

Official
by JourneyFoodsDev
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Hybrid

Journey AI MCP Server: food and CPG supplier, ingredient and commodity price data for AI agents

Journey AI is the official Model Context Protocol (MCP) server from Journey Foods. It gives AI agents and assistants such as Claude, ChatGPT, Cursor, VS Code and Perplexity read-only access to Journey's food and CPG data: supplier search and comparison, ingredient nutrition and sustainability profiles, commodity reference prices with history and forecasts, Journey Labs verified test results, and (for signed-in customers) your own product formulations.

Every tool is read-only. Journey AI never creates, changes or deletes data.

Get an API key

Get a free trial key at price.journeyfoods.io. Developer API keys for ingredient data are at dev.journeyfoods.io.

Related MCP server: ro.autoid/autoid-support

Setup

You can use the hosted server (nothing to install) or run the package locally with npx. Ready-made configs are in examples/.

Claude (claude.ai and Claude Desktop)

  • Hosted: Settings → Connectors → Add custom connector. Use the URL https://mcp.journeyfoods.io/mcp and send your key in the x-api-key header.

  • Local (Claude Desktop): add examples/claude-desktop.json to claude_desktop_config.json, then restart Claude.

Claude Code

claude mcp add --transport http journey https://mcp.journeyfoods.io/mcp --header "x-api-key: YOUR_JOURNEY_API_KEY"

ChatGPT

ChatGPT connectors need OAuth sign-in, which is coming soon on the hosted server, along with a ChatGPT directory listing. Until then, use Journey AI from any of the clients below.

Cursor

Add examples/cursor-mcp.json to .cursor/mcp.json (hosted). For local use, use the npx block from the Claude Desktop example.

VS Code

Add examples/vscode-mcp.json to .vscode/mcp.json. VS Code asks for your key and keeps it out of the file.

Perplexity

Plugins → Add custom → Connector → Add MCP connector → Remote. Use the URL https://mcp.journeyfoods.io/mcp, choose API key authentication, and paste your key.

Windsurf, Cline, Zed and other MCP clients

Point any client that supports Streamable HTTP at https://mcp.journeyfoods.io/mcp with the x-api-key header (see examples/remote-generic.json). For stdio clients, run npx -y @journeyfoods/mcp with JOURNEY_PRICE_API_KEY (and optionally JOURNEY_API_KEY) set.

Local HTTP server

JOURNEY_PRICE_API_KEY=... npx -y @journeyfoods/mcp --http   # serves http://127.0.0.1:3000/mcp
npx -y @journeyfoods/mcp --help

Tools

Tool

What it does

search_suppliers

Find food and CPG suppliers by name, ingredient, category, region or certification

get_supplier

Full supplier profile: website, country, locations, categories, certifications, verification status

compare_suppliers

Compare two to five suppliers side by side, including what they share

search_ingredients

Search the Journey ingredient database, with nutrition and sustainability scores

get_ingredient

Ingredient profile: nutrition per 100 g, scores, nutrients, allergens and attributes

get_ingredient_price

Reference price, recent history and optional forecast for a commodity such as cocoa, sugar or coffee

list_price_series

Every ingredient and commodity Journey publishes prices for (names and units only)

search_products

Search your own products and formulations (signed-in Journey accounts)

get_product

One of your products: summary, ingredients and nutrition panel

verify_lab_result

Check whether an ingredient, product or supplier has a Journey Labs verified result

If a data source isn't connected for your account, the tool says "not connected" instead of guessing.

Limits

Plan

What you can see

Requests

Free

10 suppliers, 200 ingredients, 200 products and 25 lab results per account (distinct records, lifetime)

10 per minute

Startup

Higher limits (up to 4,000 ingredients)

60 per minute

Enterprise

Contract limits

300 per minute

When you reach a limit, the tool tells you and links to upgrade options. For full data access, contact Journey about a contract.

Configuration

See .env.example. Every value comes from the environment, and no keys are stored in code. Each key is only sent to the service that issued it. The policy file format is shown in policy.example.json.

Development

npm install
npm test        # tests use mock data only, no network
npm run build

See CONTRIBUTING.md and SECURITY.md.

License

MIT © Journey Foods

mcp-name: io.journeyfoods/journey-ai

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Resources

Related MCP Connectors

Related MCP Servers

  • ro.autoid/autoid-support

    AutoID-Alex
    F
    license
    Not graded
    quality
    B
    maintenance
    Enables AI agents to search enterprise Auto-ID products and exact SKUs, read live stock and current pricing, and explore variants, accessories, consumables and support relationships through a public read-only endpoint. It also surfaces manuals, firmware, drivers and other verified technical resources from the vendor's support center.
    -

  • a2a-grocery

    greencore-solutions
    A
    license
    Not graded
    quality
    B
    maintenance
    A2A Grocery is the Agent-to-Agent (A2A) + Model Context Protocol (MCP) hub for retail grocery procurement. It puts makers, brand owners, private label, distributors and importers in front of the AI agents that now do the grocery buying, and gives retail procurement desks every cleared supplier's record, ready to order. 20 markets on the SCHEMA algo record. No ads. No rank for sale. Trade only.
    MIT

  • Peptide Library MCP Server

    ryandelauz
    A
    license
    Not graded
    quality
    C
    maintenance
    Enables AI assistants to search and retrieve structured peptide research profiles with cited, tier-labelled evidence, safety and regulatory status, and to compare two or three peptides side by side without ranking. Also provides research article and FAQ search, category and trend lookups, plus unit conversion, solution concentration, blend and cost-per-amount calculators, all read-only and anonymous.
    MIT