# Fanio

> Fanio sells character packs, one character drawn across many everyday scenes, and icon sets drawn in one style, delivered as transparent SVG, with an English and Arabic catalogue, a public read API and an MCP server for AI assistants.

Free scenes may be used in personal and commercial work without attribution. Paid scenes need the Fanio licence, which comes with the pack or with a plan. Free website downloads need no account: download from the scene page. The /v1 SVG route and MCP server never return free SVG bytes; they retain the legacy sign_in_required code and signIn field for compatibility, not as a website login requirement. Search, metadata and small PNG previews stay public. When you show or use a scene, repeat its credit line and licence.

## Packs

- [After school](https://fanio.net/packs/after-school.md): 37 kids and teens after school in thick cobalt marker with one neon orange garment: skating, music, sport, crafts and play.
- [App moments](https://fanio.net/packs/app-moments.md): 21 scenes for websites and apps: a welcome, an empty search, a payment, a sent message, a success and more.
- [Everyday Arab life](https://fanio.net/packs/arab-daily-life.md): 21 scenes of everyday life in the Arab world: the darbuka, a spice market, a shared meal, the oud, backgammon, dabke and more.
- [Art deco world](https://fanio.net/packs/art-deco-world.md): 39 icons in art deco navy and gold: a child with a balloon, a camel, a lantern, a key and more. The first subjects also come in five other styles.
- [Blue crayon doodles](https://fanio.net/packs/blue-crayon-doodles.md): 54 child-like doodles in one cobalt wax crayon: animals, vehicles, food, weather, toys and people doing one thing.
- [Blue Tonal People](https://fanio.net/packs/blue-tonal-people.md): 24 playful people in one blue family, each with one enormous head, hands or feet: flying a kite, reading, walking the dog and more.
- [Bouncy blobs](https://fanio.net/packs/bouncy-blobs.md): 99 round little creatures in a wobbly marker line over one flat colour blob: jumping, waving, dancing, playing and more.
- [Busy at home](https://fanio.net/packs/busy-at-home.md): 72 scenes of one person doing a home task: laundry, cooking, cleaning, repairs, gardening on the balcony and more.
- [Chalk folk](https://fanio.net/packs/chalk-folk.md): 23 calm little figures, each one soft chalk shape with a thin ultramarine crayon line and a small prop held out to the side: a balloon, a letter, a gift, a coffee pot, prayer beads and more.
- [Charcoal Doodle People](https://fanio.net/packs/charcoal-doodle-people.md): 10 everyday people in a thick grainy charcoal line: flying a kite, sipping coffee, taking a photo, watering a plant and more.
- [City sketches](https://fanio.net/packs/city-sketches.md): 40 people in city life drawn in bold charcoal line with a light blue head and one coloured object: coffee, flowers, balloons, music and more.
- [Crayon animals](https://fanio.net/packs/crayon-animals.md): 36 animals in red wax crayon with stripes cut out of their bodies: farm, forest, sea, birds and wild animals.
- [Crayon doodle animals](https://fanio.net/packs/crayon-doodle-animals.md): 49 soft red crayon doodles of animals with tiny black details: pets, farm, forest, sea, insects and wild animals.
- [Crayon market basket](https://fanio.net/packs/crayon-food-plants.md): 24 fruits, vegetables, bread and plants in red wax crayon with stripes cut out: apple, strawberry, carrot, mushroom, cactus, sunflower and more.
- [Crayon stripe animals](https://fanio.net/packs/crayon-stripe-animals.md): 26 playful animals in red wax crayon, each body a row of separate crayon bars: cat, zebra, lion, giraffe, kangaroo, llama, otter and more.
- [Red crayon world](https://fanio.net/packs/crayon-world.md): 39 icons in red crayon: a child with a balloon, a camel, a lantern, a key and more. The first subjects also come in five other styles.
- [Dana, everyday](https://fanio.net/packs/dana-everyday.md): Dana, drawn in paper cutout shapes, across 52 everyday moments: skipping rope, a kite and a bicycle, school and drawing, ice cream and rain, plus the small wins and the sad days.
- [Doodle creatures](https://fanio.net/packs/doodle-creatures.md): 57 cheerful creatures in flat bright colours: monsters, animals, fruit and vegetables with faces, weather and a few living household things.
- [Dry brush icons](https://fanio.net/packs/dry-brush-icons.md): 72 violet icons painted with a rough dry brush, for apps and sites in business, technology, finance, health, education, food, travel, home, sport and nature.
- [Essentials, line and accent](https://fanio.net/packs/essentials-line-accent.md): 46 everyday interface icons in rounded dark brown line with one warm accent each: home, search, mail, cart, calendar, files and more.
- [Gouache romp](https://fanio.net/packs/gouache-romp.md): 56 loud, bouncy cartoon people in dry gouache: jobs, sports, feelings, app states and Arab life, from a nurse and a saj baker to dabke, Eid balloons and Arabic coffee.
- [Gradient Line People](https://fanio.net/packs/gradient-line-people.md): 7 people in a thin black line, each with one gradient object or pet: a watering can, a cat, a coffee cup, a dog, a kite, a gift and an envelope.
- [Hot duo street food](https://fanio.net/packs/hot-duo-street-food.md): 25 mascots in orange and black for burger joints and street food: a noodle box, dancing skewers, two sauce bottles squaring up.
- [Hot duo world](https://fanio.net/packs/hot-duo-world.md): 22 icons in orange and black mascots: a child with a balloon, a camel, a lantern, a key and more. The first subjects also come in five other styles.
- [Browse all 60 packs](https://fanio.net/packs)

## For developers and agents

- [API reference](https://fanio.net/docs/api.md): the /v1 read API, licence verification and downloads
- [OpenAPI document](https://fanio.net/v1/openapi.json): machine-readable description of /v1
- [MCP server](https://fanio.net/docs/mcp.md): connect an assistant to https://fanio.net/mcp (Streamable HTTP, read-only)

## Licences

- [Fanio Free](https://fanio.net/licence/free.md): The free scene in each pack, for personal and commercial projects and client work, with no credit needed. Not for use inside templates or merchandise, not for resale, logos or AI training.
- [Fanio licence](https://fanio.net/licence/standard.md): One licence for every purchase: personal and commercial use, client work, websites and apps, and inside templates and products you sell or give away, as long as the art is part of a larger design. For one person. Not for reselling the files, logos or AI training.
- [Fanio Extended (no longer sold)](https://fanio.net/licence/extended.md): The licence of orders made before 12 November 2026 that chose Extended: everything in Standard, plus use inside products you sell or give away, as long as you do not offer the scenes as separate files. New purchases receive the one Fanio licence instead.

## بالعربية

فانيو يبيع حزم شخصيات: شخصية واحدة في مشاهد يومية كثيرة، كل مشهد ملف SVG بخلفية شفافة. الكتالوج والبحث والتراخيص كلها بالعربية أيضا.

- [بعد المدرسة](https://fanio.net/ar/packs/after-school): 37 مشهدا لأطفال ويافعين بعد المدرسة بخط أزرق كوبالتي عريض وقطعة ملابس برتقالية فاقعة: التزلج والموسيقى والرياضة والأشغال اليدوية واللعب.
- [لحظات التطبيقات](https://fanio.net/ar/packs/app-moments): 21 مشهدا للمواقع والتطبيقات: ترحيب، وبحث بلا نتائج، ودفع، ورسالة مرسلة، ونجاح، وغيرها.
- [الحياة اليومية العربية](https://fanio.net/ar/packs/arab-daily-life): 21 مشهدا من الحياة اليومية في العالم العربي: الدربكة، وسوق البهارات، ولمة الطعام، والعود، وطاولة الزهر، والدبكة، وغيرها.
- [عالم الآرت ديكو](https://fanio.net/ar/packs/art-deco-world): 39 أيقونة بالكحلي والذهبي على طراز الآرت ديكو: طفل يحمل بالونا، وجمل، وفانوس، ومفتاح وغيرها. والموضوعات الأولى متوفرة أيضا بخمسة أساليب أخرى.
- [شخبطات بالشمع الأزرق](https://fanio.net/ar/packs/blue-crayon-doodles): 54 رسمة طفولية بلون واحد من شمع التلوين الأزرق: حيوانات ومركبات وطعام وطقس وألعاب وأشخاص يقومون بشيء واحد.
- [أشخاص بدرجات الأزرق](https://fanio.net/ar/packs/blue-tonal-people): 24 شخصا مرحا بدرجات الأزرق وحدها، لكل منهم رأس أو يدان أو قدمان بحجم ضخم: يلعبون بالطائرة الورقية ويقرؤون ويتنزهون مع الكلب وغير ذلك.
- [مخلوقات وبقع لون](https://fanio.net/ar/packs/bouncy-blobs): 99 مخلوقا صغيرا مستديرا بخط متموج فوق بقعة لون مسطحة: يقفز ويلوح ويرقص ويلعب وغير ذلك.
- [مشغولون في البيت](https://fanio.net/ar/packs/busy-at-home): 72 مشهدا لشخص يقوم بمهمة منزلية: الغسيل والطبخ والتنظيف والإصلاحات والعناية بالنباتات وغيرها.
- [شخصيات الطباشير](https://fanio.net/ar/packs/chalk-folk): 23 شخصية صغيرة هادئة، كل منها شكل طباشيري ناعم بخط أزرق رفيع من قلم الشمع، تحمل شيئا صغيرا إلى جانبها: بالونا ورسالة وهدية ودلة قهوة ومسبحة وغير ذلك.
- [أشخاص بالفحم](https://fanio.net/ar/packs/charcoal-doodle-people): 10 أشخاص في لحظات يومية بخط فحم سميك محبب: يلعبون بطائرة ورقية ويشربون القهوة ويلتقطون الصور ويسقون النبات وغير ذلك.
- [رسومات من المدينة](https://fanio.net/ar/packs/city-sketches): 40 شخصا من حياة المدينة مرسومين بخط فحم عريض ورأس أزرق فاتح وشيء ملون واحد: القهوة والزهور والبالونات والموسيقى وغيرها.
- [حيوانات الطباشير](https://fanio.net/ar/packs/crayon-animals): 36 حيوانا بالطباشير الشمعي الأحمر بخطوط مفرغة في أجسامها: حيوانات المزرعة والغابة والبحر والطيور والبرية.
- [حيوانات الخربشة](https://fanio.net/ar/packs/crayon-doodle-animals): 49 رسمة خربشة ناعمة بالطباشير الأحمر لحيوانات بتفاصيل سوداء صغيرة: الأليفة وحيوانات المزرعة والغابة والبحر والحشرات والبرية.
- [سلة السوق بالطباشير](https://fanio.net/ar/packs/crayon-food-plants): 24 رسمة لفواكه وخضار وخبز ونباتات بالطباشير الشمعي الأحمر بخطوط مفرغة: التفاح والفراولة والجزر والفطر والصبار ودوار الشمس وغيرها.
- [حيوانات الخطوط الملونة](https://fanio.net/ar/packs/crayon-stripe-animals): 26 حيوانا مرحا بالطباشير الشمعي الأحمر، جسم كل منها صف من خطوط منفصلة: القطة والحمار الوحشي والأسد والزرافة والكنغر واللاما وثعلب الماء وغيرها.
- [عالم الطباشير الأحمر](https://fanio.net/ar/packs/crayon-world): 39 أيقونة بالطباشير الأحمر: طفل يحمل بالونا، وجمل، وفانوس، ومفتاح وغيرها. والموضوعات الأولى متوفرة أيضا بخمسة أساليب أخرى.
- [دانا، كل يوم](https://fanio.net/ar/packs/dana-everyday): دانا، مرسومة بأشكال ورقية مقصوصة، في 52 لحظة من يومها: القفز بالحبل والطائرة الورقية والدراجة، والمدرسة والرسم، والبوظة والمطر، مع الانتصارات الصغيرة والأيام الحزينة.
- [مخلوقات الشخبطة](https://fanio.net/ar/packs/doodle-creatures): 57 مخلوقا مرحا بألوان زاهية مسطحة: وحوش وحيوانات وفواكه وخضار بوجوه، وظواهر طقس، وبعض أغراض البيت الحية.
- [أيقونات الفرشاة الجافة](https://fanio.net/ar/packs/dry-brush-icons): 72 أيقونة بنفسجية مرسومة بفرشاة جافة خشنة، للتطبيقات والمواقع في الأعمال والتقنية والمال والصحة والتعليم والطعام والسفر والبيت والرياضة والطبيعة.
- [الأساسيات، خط ولمسة لون](https://fanio.net/ar/packs/essentials-line-accent): 46 أيقونة يومية للواجهات بخط بني داكن مستدير ولمسة لون دافئة: البيت والبحث والبريد والسلة والتقويم والملفات وغيرها.
- [مرح بالغواش](https://fanio.net/ar/packs/gouache-romp): 56 شخصية كرتونية صاخبة ومرحة بالغواش الجاف: مهن ورياضات ومشاعر وحالات تطبيقات وحياة عربية، من الممرضة وخباز الصاج إلى الدبكة وبالونات العيد والقهوة العربية.
- [أشخاص بخط ولمسة متدرجة](https://fanio.net/ar/packs/gradient-line-people): 7 أشخاص بخط أسود رفيع، مع كل منهم شيء أو حيوان واحد بلون متدرج: مرشة ماء وقطة وفنجان قهوة وكلب وطائرة ورقية وهدية وظرف.
- [أطعمة الشارع بالبرتقالي والأسود](https://fanio.net/ar/packs/hot-duo-street-food): 25 شخصية بالبرتقالي والأسود لمطاعم البرغر والأطعمة الجاهزة: علبة نودلز، وأسياخ ترقص، وزجاجتا صلصة تتخاصمان.
- [عالم الثنائي البرتقالي](https://fanio.net/ar/packs/hot-duo-world): 22 أيقونة بشخصيات البرتقالي والأسود: طفل يحمل بالونا، وجمل، وفانوس، ومفتاح وغيرها. والموضوعات الأولى متوفرة أيضا بخمسة أساليب أخرى.
- [تصفح جميع الحزم](https://fanio.net/ar/packs)
- [التراخيص](https://fanio.net/ar/licence)

## Optional

- [Expanded guide](https://fanio.net/llms-full.txt): this index plus licences and developer docs; pack pages list their scenes
- [Sitemap](https://fanio.net/sitemap.xml)

---

# Fanio Free

> The free scene in each pack, for personal and commercial projects and client work, with no credit needed. Not for use inside templates or merchandise, not for resale, logos or AI training.

## Allows

- personal projects
- commercial projects and client work
- websites and apps
- social media

## Forbids

- sharing or selling the file, changed or not
- use inside templates, merchandise or assets you sell or give away
- use as a logo or trademark
- training AI or machine-learning models

---

# Fanio licence

> One licence for every purchase: personal and commercial use, client work, websites and apps, and inside templates and products you sell or give away, as long as the art is part of a larger design. For one person. Not for reselling the files, logos or AI training.

## Allows

- personal and commercial projects
- client work
- websites and apps
- templates and products you sell or give away, with the art as part of a larger design
- changing the scenes to fit your design

## Forbids

- selling or sharing the files on their own, or as a competing library or pack
- registering a scene as a trademark or an exclusive logo
- training AI models, or making look-alike artwork with AI
- sharing your account or using it for more than one person

---

# Fanio Extended (no longer sold)

> The licence of orders made before 12 November 2026 that chose Extended: everything in Standard, plus use inside products you sell or give away, as long as you do not offer the scenes as separate files. New purchases receive the one Fanio licence instead.

## Allows

- everything in Standard
- templates and themes you sell or give away
- merchandise and printed goods
- apps

## Forbids

- offering the scenes or the pack as separate files
- use as a logo or trademark
- training AI or machine-learning models

---

# Fanio API

> A public, read-only JSON API over the Fanio catalogue, plus licence verification and signed downloads. OpenAPI 3.1: https://fanio.net/v1/openapi.json

No key is needed to read metadata, search and previews. Free scenes can be downloaded from their website pages without an account; public discovery routes and MCP do not serve SVG source. Paid originals use signed download URLs, as described below. Requests are rate limited per IP. Every scene id has the form `fanio:<pack>/<scene>`.

## Read

- `GET /v1/packs?page=1`: 24 packs per page, each with up to six preview scenes, full counts and prices
- `GET /v1/packs/{pack}?page=1`: one pack with 24 scenes per page and full counts
- `GET /v1/scenes/{pack}/{scene}`: one scene, with credit line, licence and links
- `GET /v1/scenes/{pack}/{scene}.svg`: never returns the file. A free scene answers 401 `sign_in_required` with `signIn` (the sign-in URL) and the Fanio Free `licence`; a paid scene answers 402 `licence_required`
- `GET /v1/scenes/{pack}/{scene}.png`: a 480 px preview for a free scene, or a watermarked 200 px preview for a paid scene
- `GET /v1/scenes/{pack}/{scene}/provenance`: the provenance record as JSON; this endpoint remains available even when the scene page does not display processing details
- `GET /v1/search?q=reading`: search in English or Arabic. Use `limit` (1 to 50) and `offset` for pages. Repeat `pack`, `character`, `style`, `activity`, `setting` or `season` to select several values within one facet. Add `free=true` or `free=false`, `sort=title`, and `lang=ar` if needed. The response includes `total` and facet counts. `smart=true` optionally re-ranks eligible first-page results when enabled on the server, with local fallback.
- `GET /v1/licences` and `/v1/licences/{tier}`

## Downloads

Free scenes: download directly from the scene page on the website, without signing in. The public discovery route ending in `.svg` and MCP do not send SVG bytes. The HTTP route returns 401; the MCP tool returns scene data. Both retain legacy sign-in information and a `page` link. Use the page link; free website downloads do not require signing in. Search, metadata and small PNG previews stay public.

## Paid scenes

1. `POST /v1/licences/verify` with `{"key": "fanio_lk_..."}` returns the licensed pack and tier; `pack` is `null` for an all-packs plan key.
2. `POST /v1/licences/download` with `{"key": "...", "scene": "fanio:<pack>/<scene>"}` returns a download URL valid for five minutes.

## Access and security boundaries

- The public API and MCP do not offer catalogue edits or deletion of packs or scenes. The two POST endpoints above verify a licence and issue a download link; they do not grant administrator access.
- Metadata, search, provenance and previews are public and can be read by programs. Watermarks and reduced dimensions do not make previews private. Rate limits do not guarantee prevention of gradual collection or collection from multiple addresses.
- Each paid download request selects one scene. There is no whole-pack or ZIP download operation here. The server checks the scene against the licence, rechecks the licence when the signed link is used, and applies download limits.
- A signed download link is temporary bearer access to that scene. Keep it secret and out of public content and logs. Expiry does not revoke a copy already downloaded.
- After a 429 response, stop parallel requests and wait before retrying. Do not rotate network addresses to bypass the limit.

Keep licence keys secret; they are bearer credentials. Revealing the key again on the order page rotates it.

---

# Fanio MCP server

> Connect an AI assistant to Fanio at https://fanio.net/mcp (Streamable HTTP, stateless, read-only; it never returns SVG source).

## Tools

- `search_scenes`: find scenes by words in English or Arabic, with optional exact filters and pagination
- `get_scene`: one scene by id, with credit line and licence. It never returns SVG source: a free scene returns a page link for direct website download (alongside legacy sign-in fields), and a paid scene the purchase link
- `list_packs`: list packs with an optional `page` (default 1), 24 packs per page, with counts and prices
- `get_pack`: get a pack by `slug`, with an optional `page` (default 1), 24 scenes per page
- `get_licence`: what a licence tier allows and forbids

Show the credit line and licence that come with a scene to the person you are helping.

## Connect

Add a remote MCP server with the URL `https://fanio.net/mcp` in any client that supports Streamable HTTP.