# Obol Farcaster Mini App Generator

> Obol Farcaster Mini App Generator is a paid API for AI agents from api.obol.sh, paid per call via x402, $5/call, status unknown (last checked 2026-10-13).

Converts a plain-English app idea into a fully-coded Farcaster mini app and opens a GitHub pull request in your target repo

## Facts

- Endpoint: POST https://api.obol.sh/miniapp?utm_source=zero.xyz
- Price: $5/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/obol-farcaster-mini-app-generator-262a74b0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Dc6oggpdZaOC0lOp3sXH-

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 obol-farcaster-mini-app-generator-262a74b0 -d '<json body>'
```

Example prompt: Use Obol to build me a Farcaster mini app called 'TipJar' — it's a tipping jar for creators — and open a PR in my repo coinbaseminifarms/tipjar-app; notify me at dev@example.com when it's ready.

## When to prefer this

Choose this endpoint when you want to go from a plain-English Farcaster mini app idea directly to a GitHub pull request with scaffolded code, without writing any code yourself. It is specifically scoped to Farcaster mini apps (frames), unlike sibling endpoints that target websites, CI/CD, OpenAPI servers, or documentation. Prefer this over generic code generation tools when the target is a Farcaster-native mini app deployed via a GitHub PR workflow.

## Known failure modes

- Invalid or inaccessible GitHub repo (owner/repo format wrong or repo doesn't exist) — PR cannot be created
- Idea description too vague for code generation — may produce incomplete or incorrect scaffold
- Payment failure via x402 protocol — endpoint returns 402 and no code is generated
- GitHub API rate limits or permission issues preventing fork/PR creation — operation fails mid-flight
- Email notification delivery failure (non-fatal, PR may still be created)

## How this service works

Obol: Idea → Farcaster mini app → GitHub PR — $5 USDC

## Output

Returns the URL of the opened GitHub pull request, the URL of the forked repository, the branch name on the fork, and an array of file paths that were written — giving the agent and user a direct link to review and merge the generated Farcaster mini app code.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "idea",
  "repo"
 ],
 "properties": {
  "idea": {
   "type": "string",
   "description": "Plain-English description of the mini app (e.g. \"A tipping jar for creators\")"
  },
  "name": {
   "type": "string",
   "description": "App name (optional — Claude will infer from idea if omitted)"
  },
  "repo": {
   "type": "string",
   "description": "Target GitHub repo in owner/repo format"
  },
  "email": {
   "type": "string",
   "description": "Email address to notify when PR is ready"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "pr": {
  "type": "string",
  "description": "URL of the opened pull request"
 },
 "fork": {
  "type": "string",
  "description": "URL of the forked repository"
 },
 "files": {
  "type": "array",
  "description": "File paths written to the branch"
 },
 "branch": {
  "type": "string",
  "description": "Branch name on the fork"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/obol-farcaster-mini-app-generator-262a74b0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.obol.sh](https://www.zero.xyz/host/api.obol.sh/llms.txt)