# Omo MCP Server

> Omo MCP is a free, remote Model Context Protocol server at https://omo.space/api/mcp. It lets an AI assistant such as Claude, ChatGPT, Cursor or Codex search the Omo marketplace's 284 listings, pick the right tool for a request, show its price, run it, and return the finished file in the chat. 50 listings are runnable AI tools — personalised picture books, phonics readers, worksheets, classroom printables and teacher tools — priced from $0.10 to $7.81 per run. 234 are free creator prompts for Claude Opus 5.5 videos and games. Searching needs no account; paid runs use an Omo API key.

- Endpoint: https://omo.space/api/mcp (Streamable HTTP, JSON-RPC 2.0, stateless, protocol 2025-11-25)
- Page: https://omo.space/mcp · Server card: https://omo.space/.well-known/mcp/server-card.json
- Updated: 2026-10-02

## Prompt your agent to install Omo

Paste this into any AI coding agent (Claude Code, Cursor, Codex, VS Code, Windsurf). It walks you and the agent through setup and never asks for your key in chat.

```md
# Add the Omo MCP server

Connect this AI tool to Omo, a remote MCP server at https://omo.space/api/mcp (Streamable HTTP, stateless, nothing to install). It lets you search 284 Omo listings and run paid tools that return finished files (picture books, worksheets, printables).

## Before you run any command

Show me this checklist and wait for my OK:
1. Which client you are setting up (Claude Code, Cursor, Codex, VS Code, Windsurf or other) and the exact file or command you will change.
2. Whether I want browse-only (no key) or paid runs (needs my Omo API key).
3. If paid runs: I get my key from https://omo.space/api.html myself. Never ask me to paste the key into this chat. Use an environment variable named OMO_API_KEY, or a placeholder I fill in.

## Set it up

- Claude Code: claude mcp add --transport http omo https://omo.space/api/mcp (for paid runs add: --header "Authorization: Bearer $OMO_API_KEY")
- Cursor (.cursor/mcp.json) or VS Code / Windsurf MCP config: add a server named "omo" with url https://omo.space/api/mcp and, for paid runs, header Authorization: Bearer <my key>.
- Codex (~/.codex/config.toml): [mcp_servers.omo] with url = "https://omo.space/api/mcp" and bearer_token_env_var = "OMO_API_KEY" for paid runs.
- Claude.ai, Claude Desktop or ChatGPT: tell me to add a custom connector named Omo with the URL https://omo.space/api/mcp. You cannot do this step for me.
Keep any existing MCP servers in the file. Do not overwrite them.

## Check it works

1. Reload the MCP servers and confirm "omo" lists 9 tools, including omo_search and omo_route.
2. Call omo_route with "a phonics worksheet for year 1" and show me the best match and its price.
3. Do not call omo_run. Running a tool costs money: always tell me the price and get my OK first.

Docs: https://omo.space/mcp.md
```

## Connect

```sh
claude mcp add --transport http omo https://omo.space/api/mcp --header "Authorization: Bearer omo_YOUR_KEY"
```

```json
{
  "mcpServers": {
    "omo": {
      "url": "https://omo.space/api/mcp",
      "headers": {
        "Authorization": "Bearer omo_YOUR_KEY"
      }
    }
  }
}
```

Leave the header out to browse only. Keys: https://omo.space/api.html.

## Tools

- `omo_search` — Search every listing on omo.space: runnable AI tools (picture books, worksheets, printables, teacher tools) and free creator prompts (Opus 5.5 videos and games). Returns ranked matches with price and slug. Use plain words for what the user wants.
- `omo_list_categories` — List every marketplace category with how many listings it has and example names. Use it to browse when the user has no specific search.
- `omo_route` — Give the user's goal in a sentence; get the best-matching tool, two alternatives, and what to do next. If nothing fits, returns how to request a new tool instead of guessing.
- `omo_get_listing` — Full details for one listing by slug. Runnable tools include the exact input_schema (JSON Schema) and a reviewed example_input to start from. Free prompts include the full prompt text and links.
- `omo_run` — Run a runnable listing and charge its listed per-run price to the user's Omo credits (subscribers are not charged). ALWAYS tell the user the price and get their OK first. Inputs must match the listing's input_schema. Returns a run_id; poll omo_get_run until status is completed. Failed runs are refunded automatically.
- `omo_get_run` — Status, progress and results of a run started with omo_run. When completed, returns the output and signed download links for any files (PDFs, images).
- `omo_account` — The user's Omo credit balance, subscription status and recent runs. Needs their API key.
- `omo_pricing` — How Omo pricing works: per-run prices, the subscription, top-up amounts and the secure link where the user pays. MCP never takes payments.
- `omo_request_tool` — When no listing fits, ask Omo to build it. Omo replies by email, usually within 2 days. Only send this after the user agrees and gives an email address.

## Runnable tools and prices

### Reading books

- [All About Book](https://omo.space/workflows/nonfiction-reader-maker) — $3.41 per run. Pick any topic and a reading level, get an illustrated All About book with a glossary.
- [Big Day Book](https://omo.space/workflows/life-event-book-maker) — $1.81 per run. Pick the big day and add your child's name, get a story that walks them through what will happen.
- [Comic Book](https://omo.space/workflows/comic-book-maker) — $7.81 per run. Pick what they love and their reading level, get a decodable comic with panels and speech bubbles.
- [Country Book](https://omo.space/workflows/country-book-maker) — $3.41 per run. Type a country and a reading level, get an All About book with map, food, animals and words.
- [Fairy Tale Remix](https://omo.space/workflows/fairy-tale-remix-maker) — $1.81 per run. Pick a classic fairy tale and add your child's name, get the story retold with them inside it.
- [Faith Story Book](https://omo.space/workflows/faith-story-book-maker) — $1.81 per run. Pick a story from your tradition and add your child's name, get a simple illustrated book to share.
- [Feelings Story](https://omo.space/workflows/feelings-story-maker) — $1.81 per run. Name a feeling or situation and your child, get a gentle story about getting through it.
- [First Chapter Book](https://omo.space/workflows/chapter-book-maker) — $2.21 per run. Give a name, a genre and a reading level, get a five-chapter book for a 7 to 10 year old.
- [History Book](https://omo.space/workflows/history-book-maker) — $3.41 per run. Name a period, event or person and a reading level, get an illustrated history reader with a timeline.
- [Holiday Book](https://omo.space/workflows/holiday-book-maker) — $1.81 per run. Pick the holiday and add your family, get a personalised book about how you celebrate it.
- [Joke Book](https://omo.space/workflows/joke-book-maker) — $1.81 per run. Set the reading level and their interests, get a joke book they can read out loud to you.
- [Maths Story Book](https://omo.space/workflows/maths-story-book-maker) — $1.41 per run. Pick a maths skill and something your child loves, get a story that teaches it, with a practice page.
- [Personalised Storybook](https://omo.space/workflows/storybook-maker) — $3.41 per run. Type your child's name and favourite things, get a picture book where they are the hero.
- [Science Book](https://omo.space/workflows/science-book-maker) — $3.41 per run. Pick a science topic and a reading level, get an illustrated reader with a labelled diagram page.

### Phonics

- [Alphabet Book](https://omo.space/workflows/alphabet-book-maker) — $5.41 per run. Type their name and the thing they love, get an A to Z book about it.
- [Big Kid Reader](https://omo.space/workflows/big-kid-reader-maker) — $3.01 per run. Set the age, interests and the sounds they know, get a simple decodable book that does not look babyish.
- [Personalised Phonics Picture Book](https://omo.space/workflows/illustrated-decodable-story-maker) — $1.62 per run. Turn a favourite topic into an illustrated phonics book.
- [Phonics Worksheet Generator](https://omo.space/workflows/phonics-worksheet-generator) — $0.10 per run. Create a print-ready phonics worksheet and answer key from a bounded teaching brief.

### Worksheets

- [Grammar Worksheets](https://omo.space/workflows/grammar-worksheet-maker) — $0.41 per run. Name the grammar point and year level, get a themed worksheet with an answer key.
- [Handwriting Sheets](https://omo.space/workflows/handwriting-sheet-maker) — $0.10 per run. Pick your state's school font and the words you want, get tracing sheets ready to print.
- [Homework Pack](https://omo.space/workflows/homework-pack-maker) — $0.21 per run. Choose a subject, year and topic, get a week of homework sheets with the answer key.
- [Maths Worksheets](https://omo.space/workflows/maths-worksheet-maker) — $0.21 per run. Pick the operation, year level and a theme, get a worksheet set with the answers done.
- [Quiz Sheets](https://omo.space/workflows/quiz-maker) — $0.21 per run. Type a topic and a year level, get a printable quiz with an answer key.
- [Reading Comprehension](https://omo.space/workflows/comprehension-maker) — $0.21 per run. Type a topic and a year level, get a reading passage with questions and the answers.
- [Science Worksheets](https://omo.space/workflows/science-worksheet-maker) — $0.21 per run. Name the science topic and year level, get a worksheet with a labelled diagram and an answer key.
- [Spelling Worksheets](https://omo.space/workflows/spelling-worksheet-maker) — $0.41 per run. Paste this week's spelling list, get practice sheets and a Friday test with the answers.
- [Test Paper](https://omo.space/workflows/test-maker) — $0.21 per run. Name the unit and year level, get a test paper with sections, marks and a marking guide.
- [Vocabulary Worksheets](https://omo.space/workflows/vocabulary-worksheet-maker) — $0.21 per run. Paste a word list and pick a year level, get definition, sentence and gap-fill worksheets.

### Activities and printables

- [Activity Book](https://omo.space/workflows/activity-book-maker) — $0.21 per run. Pick an age and a theme, get a book of mazes, dot-to-dots and spot-the-difference.
- [Bingo Cards](https://omo.space/workflows/bingo-maker) — $1.61 per run. Paste a word list or a topic, get a class set of bingo cards and a call sheet.
- [Board Game](https://omo.space/workflows/board-game-maker) — $0.10 per run. Pick a topic, a level and a game style, get one printable game board.
- [Certificate](https://omo.space/workflows/certificate-maker) — $1.61 per run. Type the child's name, the achievement and a theme, get a certificate that looks worth keeping.
- [Classroom Escape Room](https://omo.space/workflows/escape-room-maker) — $0.10 per run. Type a topic and year level, get a classroom escape room booklet with puzzles, codes and answers.
- [Classroom Poster](https://omo.space/workflows/poster-maker) — $1.61 per run. Name the topic and pick a style and size, get a classroom poster ready to print.
- [Colouring Book](https://omo.space/workflows/colouring-book-maker) — $1.81 per run. Type your child's name and favourite things, get a colouring book about them.
- [Flashcards](https://omo.space/workflows/flashcard-maker) — $1.61 per run. Type a topic or paste a word list, get picture flashcards ready to print and cut.
- [Kids Recipe Book](https://omo.space/workflows/recipe-book-maker) — $1.41 per run. List a few dishes and add your child's name, get an illustrated cookbook with steps they can read.
- [Memory Match Cards](https://omo.space/workflows/memory-match-maker) — $1.61 per run. Type a topic or word list, get pairs of picture and word cards for a memory game.
- [Name Labels](https://omo.space/workflows/label-maker) — $1.61 per run. Type your child's name and pick an icon, get a sheet of labels for books, lunchboxes and bottles.
- [Puzzle Book](https://omo.space/workflows/puzzle-book-maker) — $0.10 per run. Paste a word list, choose a year level, get a complete word-search booklet.
- [Reward Chart](https://omo.space/workflows/reward-chart-maker) — $0.10 per run. Type your child's name and favourite thing, get a reward chart to mark each day.
- [Routine Chart](https://omo.space/workflows/routine-chart-maker) — $1.61 per run. List the morning or bedtime steps and add your child's name, get a picture chart they can follow.
- [Search and Find Book](https://omo.space/workflows/search-and-find-book-maker) — $0.81 per run. Type your child's name and a theme, get a busy-scene book where they find themselves in every picture.
- [Sticker and Cut-Out Sheets](https://omo.space/workflows/sticker-and-cut-out-maker) — $1.21 per run. Pick a theme, get a background scene page and a matching sheet of cut-out pieces.
- [Treasure Hunt](https://omo.space/workflows/treasure-hunt-maker) — $1.61 per run. Set a reading level and the rooms in your house, get clue cards for a treasure hunt.

### Writing

- [Poetry Book](https://omo.space/workflows/poetry-book-maker) — $1.81 per run. Choose a theme and a reading level, get an illustrated book of rhymes and short poems.
- [Writing Prompts](https://omo.space/workflows/writing-prompt-maker) — $0.21 per run. Pick a genre, year level and theme, get a picture prompt with sentence starters and a word bank.

### Languages

- [Bilingual Book](https://omo.space/workflows/bilingual-book-maker) — $2.61 per run. Choose a language, topic and level, get a picture book with English and your home language facing.

### Teacher tools

- [Lesson Plan](https://omo.space/workflows/lesson-plan-maker) — $0.10 per run. Type a topic, year level and curriculum, get a lesson plan with a resources list.
- [Report Comments](https://omo.space/workflows/report-comment-maker) — $0.10 per run. Give the subject, a few strengths and next goals, get a set of report comments using first names only.

### Free Claude Opus 5.5 prompts (234)

Browser games: https://omo.space/opus-5-5-game-prompts. Videos: https://omo.space/content-and-ads.

## FAQ

### What is the Omo MCP server?

A remote MCP server at https://omo.space/api/mcp that exposes the whole Omo marketplace to AI assistants through 9 tools: route a goal, search, browse categories, read a listing, run a tool, check a run, check credits, see pricing, and request a tool that does not exist yet.

### Which AI assistants can use it?

Any client that supports remote MCP over Streamable HTTP, including Claude (claude.ai, Claude Desktop and Claude Code), ChatGPT in developer mode, Cursor, VS Code, Windsurf and OpenAI Codex. Nothing is installed locally.

### Is the Omo MCP server free?

Connecting, searching, browsing and reading listings are free and need no account. Running a paid tool costs that tool's listed price, from $0.10 to $7.81 per run, taken from prepaid Omo credits. Subscribers ($20 a month) run tools without per-run charges. The 234 Opus 5.5 prompts are always free.

### Will my assistant spend money without asking?

The run tool tells the assistant to state the price and get your OK first, and MCP clients show a confirmation before calling a tool that is not read-only. Only one tool, omo_run, can cost money. A run that fails is refunded automatically, and retrying with the same idempotency key never charges twice.

### Do I need an API key?

Not to browse. For paid runs and balance checks, copy your omo_ key from https://omo.space/api.html and add it to the MCP config as "Authorization: Bearer omo_YOUR_KEY", or give it to the assistant when it asks.

### What can it make?

Examples: a personalised storybook with your child as the hero ($3.41), a decodable phonics picture book, spelling, maths and grammar worksheets, bingo cards, flashcards, reward charts, certificates, lesson plans and report comments. Files come back as signed download links, usually PDFs.

### How is this different from a ChatGPT or Claude prompt?

A prompt returns text. Omo tools are tested workflows that return finished, print-ready files — illustrated books, laid-out worksheets, cards — with fixed inputs, a fixed price and automatic refunds when a run fails a quality check.

### Where do payments happen?

Only on omo.space, through Stripe. The MCP server never sees card details. omo_pricing returns the top-up link (https://omo.space/billing.html).

### What if nothing on Omo fits?

The assistant can call omo_request_tool with your email and what you need. Omo replies by email, usually within 2 days.