# ioswarm Meal Planner

> ioswarm Meal Planner is a paid API for AI agents from ioswarm.io, paid per call via x402, $1.1/call, status unknown (last checked 2026-10-12).

Generates a personalized weekly meal plan with a shopping list based on stated dietary goals, returning results asynchronously via a poll URL.

## Facts

- Endpoint: POST https://ioswarm.io/api/v1/x402/run/meals?utm_source=zero.xyz
- Price: $1.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ioswarm-meal-planner-813eafb1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_zevoF5Mzn9S6ZAGVDFzm0

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability ioswarm-meal-planner-813eafb1 -d '<json body>'
```

Example prompt: Can you plan a week of meals for me? I'm trying to lose weight, eating around 1800 calories a day, and I prefer high-protein, low-carb meals — no shellfish. Include a shopping list for everything I'll need.

## When to prefer this

Use this endpoint when you need a complete, structured weekly meal plan with a shopping list tailored to specific dietary goals — especially when the user has calorie targets, dietary restrictions, or fitness objectives. Prefer this over generic recipe APIs when a full week's worth of coordinated meals and ingredients list is the desired output. Best suited for async workflows where a 3–10 minute response time is acceptable.

## Known failure modes

- Invalid or missing 'input' body field returns a validation error
- Insufficient USDC payment causes rejection before processing begins
- Poll URL returns pending status during the 3–10 minute generation window
- Malformed dietary brief may produce a generic or incomplete meal plan
- Wallet payment failure prevents run from starting

## How this service works

A week of meals planned around stated goals, with a shopping list. Pay $1.10 USDC per run; the response carries a run id and poll URL, the report lands in 3–10 minutes. No account needed — the paying wallet becomes the account and an API key is returned once.

## Output

The immediate response includes a run ID and a poll URL. After 3–10 minutes, polling that URL delivers the complete meal plan (7 days of structured meals) and an accompanying shopping list. An API key is also returned on first use, tied to the paying wallet.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "required": [
      "input"
     ],
     "properties": {
      "input": {
       "type": "string",
       "description": "The question or brief."
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ioswarm-meal-planner-813eafb1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from ioswarm.io](https://www.zero.xyz/host/ioswarm.io/llms.txt)