# Superstack

> Open-source Laravel starter with Filament, NativePHP SuperNative, and MCP

- **Type:** MCP server
- **Install:** `agentstack add mcp-nativephp-superstack`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [NativePHP](https://agentstack.voostack.com/s/nativephp)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [NativePHP](https://github.com/NativePHP)
- **Source:** https://github.com/NativePHP/superstack
- **Website:** https://nativephp.com

## Install

```sh
agentstack add mcp-nativephp-superstack
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Super Stack

Open-source Laravel starter kit with **Filament**, **NativePHP SuperNative**, and **Laravel MCP**.

## Stack

| Piece | Package |
| --- | --- |
| Laravel | [`laravel/framework`](https://laravel.com/docs) |
| Admin | [`filament/filament`](https://filamentphp.com/docs) (panel at `/admin`) |
| API auth | [`laravel/sanctum`](https://laravel.com/docs/sanctum) — wired, not demoed |
| Mobile / SuperNative | [`nativephp/mobile`](https://nativephp.com/docs/mobile/4/getting-started/introduction) |
| Native UI | [`nativephp/mobile-ui`](https://github.com/NativePHP/mobile-ui) |
| Web UI (browser EDGE) | [`nativephp/web-ui`](https://packagist.org/packages/nativephp/web-ui) |
| MCP server | [`laravel/mcp`](https://laravel.com/docs/mcp) — no auth added |

## Requirements

- PHP 8.4+ (Herd recommended)
- Composer
- Node (optional, for Vite)
- Xcode / Android Studio for native runs ([NativePHP Mobile v4 environment](https://nativephp.com/docs/mobile/4/getting-started/environment))

## Quick start

### Laravel installer

```bash
laravel new my-app --using=nativephp/superstack
```

### Laravel Herd

In Herd’s site creation wizard, choose a **community / custom starter kit** and enter `nativephp/superstack`.

### After create

```bash
cd my-app
php artisan migrate
# NativePHP (re-run after upgrades)
php artisan native:install both --no-interaction
```

Create a Filament admin user with the [Filament installation docs](https://filamentphp.com/docs/panels/installation#creating-a-user) (`php artisan make:filament-user`).

With Laravel Herd, the site is available at `http://my-app.test` (or whatever you named the project).

- Home (SuperNative via Web UI): [http://superstack.test](http://superstack.test)
- Admin panel: [http://superstack.test/admin](http://superstack.test/admin)
- API: Sanctum is installed (`routes/api.php`) — wired for token auth, not demoed with sample endpoints beyond `/api/user`

## MCP

Routes live in `routes/ai.php`. **No authentication is configured** on the MCP server — fine for local exploration, not production-ready as-is.

- Web: `POST /mcp/superstack`
- Local: `php artisan mcp:start superstack`

Starter tool: `app-info` (`App\Mcp\Tools\AppInfoTool`) — returns app + package versions.

```bash
php artisan mcp:inspector mcp/superstack
```

See the [Laravel MCP docs](https://laravel.com/docs/mcp) for servers, tools, and auth options.

## Native / SuperNative

Home is a SuperNative screen (`Route::native`). On a phone, [NativePHP Mobile v4](https://nativephp.com/docs/mobile/4/getting-started/introduction) renders it natively; in the browser, Web UI renders the same Blade as HTML.

```bash
php artisan native:run
```

See [Installation](https://nativephp.com/docs/mobile/4/getting-started/installation) and [SuperNative](https://nativephp.com/docs/mobile/4/architecture/super-native).

`NATIVEPHP_APP_ID` defaults to `com.superstack.app` in `.env`. The `nativephp/` directory is gitignored — regenerate with `php artisan native:install`.

## License

MIT © Bifrost Technologies LLC. See [LICENSE](LICENSE) and [CONTRIBUTING](CONTRIBUTING.md).

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [NativePHP](https://github.com/NativePHP)
- **Source:** [NativePHP/superstack](https://github.com/NativePHP/superstack)
- **License:** MIT
- **Homepage:** https://nativephp.com

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** yes
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-nativephp-superstack
- Seller: https://agentstack.voostack.com/s/nativephp
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.
