# Portal Nexus

## What is Portal Nexus?
Portal Nexus is your unified access to create, powering your agents with specialized models. One API key and one credit balance cover sprites, 3D models, voice, music, NPC AI, and game engine MCP tools — with smart routing, automatic failover, and usage analytics. Tagline: One Service. Many Creations.

## Products & Features
- Tool catalog: Browse 25+ AI game-dev tools (2D, 3D, voice, music, NPC, code).
- Smart routing: Choose cheapest, best, or fastest provider per request.
- Unified billing: One credit balance across all providers; no markup on provider rates.
- MCP hub: Local MCP server for Cursor and agents (`@gamerouter/mcp`).
- Playground: Test generation flows before integrating.
- Dashboard: API keys, credits, usage, analytics, and project settings.
- Docs: Quickstart, API reference, engine guides (Godot, Unity), MCP architecture.
- Tutorials: Step-by-step Portal Studio and MCP agent workflows at /tutorials.
- Portal Studio (sibling app): https://studio.portalgaming.com — visual agent workspace in the Portal ecosystem.

## Who We Serve
- Solo and indie game developers
- Small studios integrating AI into production pipelines
- Agent builders wiring game-dev tools via MCP
- Engine plugin and tooling authors

## Key Pages
- Homepage: https://nexus.portalgaming.com/
- About Us: https://nexus.portalgaming.com/about
- How It Works: https://nexus.portalgaming.com/how-it-works
- Tutorials: https://nexus.portalgaming.com/tutorials
- Contact: https://nexus.portalgaming.com/contact
- Tools: https://nexus.portalgaming.com/tools
- Engines: https://nexus.portalgaming.com/engines
- Create: https://nexus.portalgaming.com/create
- Projects: https://nexus.portalgaming.com/projects
- Rankings: https://nexus.portalgaming.com/rankings
- Pricing: https://nexus.portalgaming.com/pricing
- Dashboard: https://nexus.portalgaming.com/dashboard
- For AI Agents: https://nexus.portalgaming.com/for-agents
- Open Graph preview: https://nexus.portalgaming.com/nexus-opengraph.png?v=20260614
- Robots: https://nexus.portalgaming.com/robots.txt
- Sitemap: https://nexus.portalgaming.com/sitemap.xml

## API Overview
- Base path: `/api/v1/`
- Auth: `Authorization: Bearer <api_key>`
- Endpoints: `/generate/2d`, `/generate/3d`, `/generate/image`, `/generate/voice`, `/generate/music`, `/npc/chat`, `/tools`, `/engines`, `/projects`, `/projects/folders`, `/projects/assets`, `/credits`, `/usage`, `/mcp/connect`, `/mcp/execute`
- MCP package: `packages/gamerouter-mcp` — stdio MCP calling Portal Nexus HTTP routes with `GAMEROUTER_API_KEY` (includes project folder list/save tools)

## Technology & Integrations
- Next.js App Router, TypeScript, Tailwind CSS, shadcn/ui
- Supabase (Postgres + RLS), Clerk auth, Stripe billing (planned/production rollout)
- Supported engine references: Godot, Unity, Unreal, GB Studio, Web/Phaser
- Provider references: PixelLab, Meshy, ElevenLabs, Suno, Inworld, Fal.ai, and others in the tool catalog

## Frequently Asked Questions
Q: What does Portal Nexus do?
A: Portal Nexus routes game-development AI requests to the best provider, bills from one credit balance, and exposes tools through REST and MCP.

Q: How is billing handled?
A: Developers purchase credits. Platform fee applies on credit purchase; underlying provider rates are not marked up.

Q: Does Portal Nexus run MCP on its servers?
A: MCP processes run locally on the developer machine. HTTP API calls use your Portal Nexus API key for generation and billing.

Q: Is there information for AI agents?
A: Yes. See /for-agents and /llms.txt for structured, crawlable summaries.