# MagicBox.Tools

> MagicBox.Tools is an AI tool directory. Explore thousands of AI tools across
> categories like writing, image, video, code, voice, business, and more.
> Every listed tool gets a dedicated page with description, screenshots,
> traffic data, and tech stack.

This site is agent-native: AI agents can submit tools, track submission
status, and search the directory programmatically.

## Submit a tool (agent-native)

- REST API: POST https://magicbox.tools/api/v1/sites with `Authorization: Bearer mb_live_...`
  (create an API key at https://magicbox.tools/settings/api-keys)
- MCP server (streamable HTTP): https://magicbox.tools/api/mcp/mcp
  Tools: submit_site, get_site_status (need API key via Authorization header),
  search_tools, get_tool (no auth required)
- Web form: https://magicbox.tools/submit

Submission flow: paid plans are basic ($15.9 one-time), featured ($19.9
one-time) and pro ($29.9/mo sponsor slot). Members with daily quota submit
free via API. If payment is required the API returns HTTP 402 with a
`checkout_url` — open it in a browser to pay, then the submission is queued
automatically. Poll GET /api/v1/sites/{site_id} to track status:
pending_payment → queued → crawling → pending_review → live.

## Docs

- [API reference](https://magicbox.tools/api): full REST API documentation
- [OpenAPI spec](https://magicbox.tools/api/v1/openapi.json): machine-readable API schema
- [Pricing](https://magicbox.tools/pricing): listing plans
- [Submit](https://magicbox.tools/submit): web submission form

## Directory

- [Home](https://magicbox.tools/): featured and latest AI tools
- [Categories](https://magicbox.tools/category): browse tools by category
- Tool pages live at https://magicbox.tools/ai/{name}