storeboard-mcp

# Storeboard MCP server

Connect an MCP-compatible agent to Storeboard and generate exact-size App Store and Google Play assets from the conversation.

This repository contains the public metadata and client configuration for Storeboard's hosted MCP server. The hosted endpoint is:

```text
https://storeboard.dev/api/mcp
```

Storeboard uses Streamable HTTP and the same Bearer API keys, credits, account limits, generation pipeline, and QA process as the web application and REST API.

## Links

- [API and MCP documentation](https://storeboard.dev/docs/api)
- [Create an API key](https://storeboard.dev/app/keys)
- [Storeboard](https://storeboard.dev)

## Available tools

| Tool | Purpose |
| --- | --- |
| `list_specs` | List supported assets, exact pixel sizes, and credit costs |
| `get_credits` | Read the current plan, credits, and usage limits |
| `analyze_app` | Analyze an app URL, description, or reference screenshot |
| `generate_screenshot` | Generate an exact-size screenshot or Play feature graphic |
| `generate_listing` | Generate Apple and Google Play listing copy |

Low-quality image drafts are free. Medium and high quality images cost credits and are checked against the requested headline. Supplying `appScreen` makes Storeboard composite the real app UI into a deterministic device frame.

## Claude Code

Create a Storeboard API key, then run:

```bash
claude mcp add --transport http storeboard \
  https://storeboard.dev/api/mcp \
  --header "Authorization: Bearer sb_live_your_key"
```

## JSON configuration

For clients that accept MCP server JSON:

```json
{
  "mcpServers": {
    "storeboard": {
      "type": "http",
      "url": "https://storeboard.dev/api/mcp",
      "headers": {
        "Authorization": "Bearer sb_live_your_key"
      }
    }
  }
}
```

Keep the key out of source control. If your client supports environment interpolation, use it instead of writing a key directly in the configuration file.

## Example prompts

```text
Analyze https://myapp.example and propose five App Store screenshot concepts.
```

```text
List the available Storeboard specs, then create a free iPhone draft for the first concept.
```

```text
Write Apple and Google Play listing copy using these screenshot headlines.
```

## Registry metadata

[`server.json`](./server.json) describes the hosted server for the official MCP Registry. [`smithery-config-schema.json`](./smithery-config-schema.json) maps a user-provided Storeboard authorization value to the upstream `Authorization` header for Smithery.

This metadata repository is available under the MIT License. Use of the hosted Storeboard service remains subject to Storeboard's terms.

<!-- mcp-name: io.github.ophydami/storeboard -->