Articles on: Integrations & API

How do I create and manage API keys?

The Magica API and MCP server shut down on December 1, 2026. To keep your projects working, move them to Spiral. See How do I move from the Magica API to Spiral?.


API keys let your own software, or an MCP client, use Magica's models and tools. They work with the public REST API and the MCP server.


Create a key


New API keys can no longer be created. Your existing keys keep working until December 1, 2026.


To keep using these models and tools after that date, create a key in Spiral instead. Spiral has every Magica model and tool, plus lots more.


Keep keys safe


  • Treat a key like a password. Store it in a secret manager or server-side environment variable.
  • Never put a key in client-side code, a public repository, or a support ticket.


Revoke a key


Open API Keys settings, select Manage, then select Revoke next to the key. Requests that use it stop working immediately. You can still revoke keys after your subscription ends.


Revoke your Magica key once your project works with Spiral.


Copy-paste migration prompt


Send this prompt to the AI agent that works on your project, such as Claude Code, Cursor, or Codex.


Send the prompt to your agent


Migrate this project from the Magica API and MCP server to Spiral. The Magica API and MCP server shut down on December 1, 2026.

1. Read https://spiral.ai/llms.txt and https://spiral.ai/SKILL.md to learn how Spiral works.
2. Find every place that uses Magica: the base URL https://inference.magica.com/v1, the MCP server https://inference.magica.com/v1/mcp, gx_ API keys, MAGICA_* environment variables, and MCP client configs (Claude, Cursor, Codex, ChatGPT, VS Code and others).
3. Help me sign in to Spiral and create an API key at https://spiral.ai/start, or connect the Spiral MCP server at https://api.spiral.ai/mcp with browser sign-in. Store the new key where the Magica key was stored. Never print or commit it.
4. For each Magica model or tool in use, find the Spiral equivalent with Spiral's catalog search, check its input schema and price, and update the calls. Spiral has every Magica model and tool, plus many more.
5. Replace the Magica MCP server with Spiral's in every MCP config.
6. Run one low-cost test call through Spiral, then show me what changed and anything you could not migrate.

Remove the Magica key only after I confirm everything works.


Your agent will handle the migration setup


Your agent finds every place your project uses Magica, connects it to Spiral, and runs one low-cost test call. It then shows you what changed.


Good to know


Magica credits don't carry over. For a one-time credit transfer, open a support ticket or email support@magica.com before December 1, 2026.


Media generated through the API or MCP is deleted automatically after 7 days. Download any outputs you want to keep.


See the migration guide for more detail.

Updated on: 16/11/2026

Was this article helpful?

Share your feedback

Cancel

Thank you!