Omo MCP
Omo MCP Server: the Omo marketplace inside your AI assistant.
Connect once. Then Claude, ChatGPT, Cursor or Codex can search every Omo listing, pick the right tool for what you asked, show you the price, run it, and hand back the finished file — inside the conversation.
What is the 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.
Updated · 284 listings · 9 tools · protocol 2025-11-25
Parents
“Make a bedtime story where Leo goes to the moon.” Your assistant finds Personalised Storybook, quotes the price and hands back an illustrated PDF.
Teachers
“A year 2 spelling test on animal words, and bingo cards for Friday.” Two tools, two printable files, without leaving the chat.
Builders
“Find an Opus 5.5 prompt for a 3D browser racing game.” Free prompts come back in full, with the creator credited.
Live, not a mock-up
Try the search your assistant uses
This box calls the real Omo MCP server with the same omo_route and omo_search tools your assistant gets. Searching is free and needs no key.
Nine tools
What tools does Omo MCP give your assistant?
Your assistant picks these on its own. Read-only tools are free. Only omo_run costs money, and only after you agree to the price.
| Tool | Name | What it does | Cost |
|---|---|---|---|
omo_search | Search the Omo marketplace | 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. | Free |
omo_list_categories | Browse marketplace 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. | Free |
omo_route | Route a goal to the right tool | 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. | Free |
omo_get_listing | Get one listing in full | 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. | Free |
omo_run | Run a paid tool | 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. | Listed price |
omo_get_run | Check a run and get its files | 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). | Free |
omo_account | Check credits and recent runs | The user's Omo credit balance, subscription status and recent runs. Needs their API key. | Free |
omo_pricing | Pricing and top-ups | How Omo pricing works: per-run prices, the subscription, top-up amounts and the secure link where the user pays. MCP never takes payments. | Free |
omo_request_tool | Request a tool that does not exist | 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. | Free |
Fastest setup
Prompt your agent to install Omo
Paste this prompt into any AI coding agent: Claude Code, Cursor, Codex, VS Code or Windsurf. It shows you a setup checklist first, adds the server, then checks that it works. It never asks for your key in chat.
# 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
Two-minute setup
How do I add Omo MCP to Claude, ChatGPT, Cursor or Codex?
Omo is a remote MCP server at https://omo.space/api/mcp (Streamable HTTP). Nothing to install. Add your API key as a Bearer token so paid runs work without pasting it into chat.
Replace omo_YOUR_KEY with your key from omo.space/api.html. Leave the header out if you only want to browse.
claude mcp add --transport http omo \
https://omo.space/api/mcp \
--header \
"Authorization: Bearer omo_YOUR_KEY"
{
"mcpServers": {
"omo": {
"url": "https://omo.space/api/mcp",
"headers": {
"Authorization":
"Bearer omo_YOUR_KEY"
}
}
}
}
[mcp_servers.omo]
url = "https://omo.space/api/mcp"
[mcp_servers.omo.http_headers]
Authorization = "Bearer omo_YOUR_KEY"
Settings → Connectors → Add custom connector. Name it Omo and paste https://omo.space/api/mcp. Give your key when the assistant asks to run something.
In developer mode, add a connector with the same URL. Searching and browsing work straight away.
POST JSON-RPC 2.0 to the URL, start with initialize, then tools/list. Stateless: no session id to keep.
Leave the key out. Search, routing, listings and free prompts all work without one.
Everything it can run
What can my assistant make with Omo?
Every runnable tool and its fixed price per run. Each one returns a finished file. Prices are the same as on omo.space.
Reading books 14
- All About Book $3.41Pick any topic and a reading level, get an illustrated All About book with a glossary.
- Big Day Book $1.81Pick the big day and add your child's name, get a story that walks them through what will happen.
- Comic Book $7.81Pick what they love and their reading level, get a decodable comic with panels and speech bubbles.
- Country Book $3.41Type a country and a reading level, get an All About book with map, food, animals and words.
- Fairy Tale Remix $1.81Pick a classic fairy tale and add your child's name, get the story retold with them inside it.
- Faith Story Book $1.81Pick a story from your tradition and add your child's name, get a simple illustrated book to share.
- Feelings Story $1.81Name a feeling or situation and your child, get a gentle story about getting through it.
- First Chapter Book $2.21Give a name, a genre and a reading level, get a five-chapter book for a 7 to 10 year old.
- History Book $3.41Name a period, event or person and a reading level, get an illustrated history reader with a timeline.
- Holiday Book $1.81Pick the holiday and add your family, get a personalised book about how you celebrate it.
- Joke Book $1.81Set the reading level and their interests, get a joke book they can read out loud to you.
- Maths Story Book $1.41Pick a maths skill and something your child loves, get a story that teaches it, with a practice page.
- Personalised Storybook $3.41Type your child's name and favourite things, get a picture book where they are the hero.
- Science Book $3.41Pick a science topic and a reading level, get an illustrated reader with a labelled diagram page.
Phonics 4
- Alphabet Book $5.41Type their name and the thing they love, get an A to Z book about it.
- Big Kid Reader $3.01Set the age, interests and the sounds they know, get a simple decodable book that does not look babyish.
- Personalised Phonics Picture Book $1.62Turn a favourite topic into an illustrated phonics book.
- Phonics Worksheet Generator $0.10Create a print-ready phonics worksheet and answer key from a bounded teaching brief.
Worksheets 10
- Grammar Worksheets $0.41Name the grammar point and year level, get a themed worksheet with an answer key.
- Handwriting Sheets $0.10Pick your state's school font and the words you want, get tracing sheets ready to print.
- Homework Pack $0.21Choose a subject, year and topic, get a week of homework sheets with the answer key.
- Maths Worksheets $0.21Pick the operation, year level and a theme, get a worksheet set with the answers done.
- Quiz Sheets $0.21Type a topic and a year level, get a printable quiz with an answer key.
- Reading Comprehension $0.21Type a topic and a year level, get a reading passage with questions and the answers.
- Science Worksheets $0.21Name the science topic and year level, get a worksheet with a labelled diagram and an answer key.
- Spelling Worksheets $0.41Paste this week's spelling list, get practice sheets and a Friday test with the answers.
- Test Paper $0.21Name the unit and year level, get a test paper with sections, marks and a marking guide.
- Vocabulary Worksheets $0.21Paste a word list and pick a year level, get definition, sentence and gap-fill worksheets.
Activities and printables 17
- Activity Book $0.21Pick an age and a theme, get a book of mazes, dot-to-dots and spot-the-difference.
- Bingo Cards $1.61Paste a word list or a topic, get a class set of bingo cards and a call sheet.
- Board Game $0.10Pick a topic, a level and a game style, get one printable game board.
- Certificate $1.61Type the child's name, the achievement and a theme, get a certificate that looks worth keeping.
- Classroom Escape Room $0.10Type a topic and year level, get a classroom escape room booklet with puzzles, codes and answers.
- Classroom Poster $1.61Name the topic and pick a style and size, get a classroom poster ready to print.
- Colouring Book $1.81Type your child's name and favourite things, get a colouring book about them.
- Flashcards $1.61Type a topic or paste a word list, get picture flashcards ready to print and cut.
- Kids Recipe Book $1.41List a few dishes and add your child's name, get an illustrated cookbook with steps they can read.
- Memory Match Cards $1.61Type a topic or word list, get pairs of picture and word cards for a memory game.
- Name Labels $1.61Type your child's name and pick an icon, get a sheet of labels for books, lunchboxes and bottles.
- Puzzle Book $0.10Paste a word list, choose a year level, get a complete word-search booklet.
- Reward Chart $0.10Type your child's name and favourite thing, get a reward chart to mark each day.
- Routine Chart $1.61List the morning or bedtime steps and add your child's name, get a picture chart they can follow.
- Search and Find Book $0.81Type your child's name and a theme, get a busy-scene book where they find themselves in every picture.
- Sticker and Cut-Out Sheets $1.21Pick a theme, get a background scene page and a matching sheet of cut-out pieces.
- Treasure Hunt $1.61Set a reading level and the rooms in your house, get clue cards for a treasure hunt.
Writing 2
- Poetry Book $1.81Choose a theme and a reading level, get an illustrated book of rhymes and short poems.
- Writing Prompts $0.21Pick a genre, year level and theme, get a picture prompt with sentence starters and a word bank.
Languages 1
- Bilingual Book $2.61Choose a language, topic and level, get a picture book with English and your home language facing.
Teacher tools 2
- Lesson Plan $0.10Type a topic, year level and curriculum, get a lesson plan with a resources list.
- Report Comments $0.10Give 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
Creators' exact prompts for browser games and videos, with credit and a SKILL.md download. Your assistant gets the full prompt text from omo_get_listing.
Why not just prompt?
Omo MCP vs a plain chat prompt
Your assistant can write a story on its own. Omo tools return the finished, laid-out file, at a price you see first.
| Omo tool via MCP | Plain chat prompt | |
|---|---|---|
| What it returns | Finished files (PDF books, worksheets, cards) | Text you still have to lay out |
| Price | Fixed, shown before it runs ($0.10–$7.81) | Your chat subscription |
| Failed output | Refunded automatically | Re-prompt and try again |
| Inputs | Validated fields (name, level, page count) | Free text |
| Where it runs | Inside your assistant via MCP | Inside your assistant |
Before the first paid run
Get an API key
Your key links paid runs and balance checks to your Omo credits. New accounts start with free credit.
Open the API page
Sign in at omo.space/api.html and copy your personal omo_ key.
Put it in the config
Use it as the Bearer token above. Treat it like a password: anyone with it can spend your credits.
Ask naturally
Try: “Find me a tool for a phonics book about dinosaurs, tell me the price, and ask before you run it.”
You see the price before anything runs
Each tool has a fixed price per run, from $0.10. Your assistant must show it and wait for your yes. Subscribers run tools without per-run charges. A run that fails is refunded automatically. Payments only ever happen on omo.space through Stripe — never inside the chat.
Questions
Omo MCP FAQ
Plain answers. Also available as Markdown and as a server card. The story behind it: how the Omo Space MCP server works.
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.