# Studio Signal — Developer API & MCP

> AI-powered media & entertainment intelligence for developers and AI agents.
> REST API, MCP server (stdio + remote HTTP), and Claude plugin.

## Quick links

- Developer portal: https://developer.studiosignal.app
- Platform: https://studiosignal.app
- API base: https://studiosignal.app/api/v1
- OpenAPI spec: https://studiosignal.app/api/v1/openapi.json
- MCP Registry: https://registry.modelcontextprotocol.io (search: io.github.vfxprojoe/studio-signal)
- npm MCP package: https://www.npmjs.com/package/@studiosignal/mcp-server
- GitHub (main app): https://github.com/vfxprojoe/studiosignal
- Claude plugin: https://github.com/vfxprojoe/studiosignal-plugin
- Privacy policy: https://studiosignal.app/legal

## Authentication

Get a free API key at https://developer.studiosignal.app (Profile → API Key).
Use `Authorization: Bearer ss_live_your_key` for REST and MCP HTTP.
Set `STUDIO_SIGNAL_API_KEY=ss_live_your_key` for the local MCP stdio server.

## MCP Server

Registry name: `io.github.vfxprojoe/studio-signal`
npm package: `@studiosignal/mcp-server`

### Local install (stdio) — Cursor, Claude Desktop, Windsurf

Add to `.cursor/mcp.json` or `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "studio-signal": {
      "command": "npx",
      "args": ["-y", "@studiosignal/mcp-server"],
      "env": {
        "STUDIO_SIGNAL_API_KEY": "ss_live_your_key"
      }
    }
  }
}
```

### Cursor one-click install

cursor://anysphere.cursor-deeplink/mcp/install?name=studio-signal&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBzdHVkaW9zaWduYWwvbWNwLXNlcnZlciJdLCJlbnYiOnsiU1RVRElPX1NJR05BTF9BUElfS0VZIjoic3NfbGl2ZV95b3VyX2tleV9oZXJlIn19

Replace `ss_live_your_key_here` in Cursor settings after install.

### Remote HTTP (no local install)

Endpoint: https://studiosignal.app/api/mcp
Transport: streamable-http
Auth: OAuth sign-in or `Authorization: Bearer ss_live_*`

```json
{
  "mcpServers": {
    "studio-signal": {
      "url": "https://studiosignal.app/api/mcp",
      "transport": "streamable-http"
    }
  }
}
```

### MCP tools

- ask_kai — M&E research with inline citations and source URLs
- get_daily_brief — Today's executive intelligence brief
- get_deep_dive — In-depth analysis of the top story
- get_stocks — Live M&E sector stock data (30+ companies)
- get_usage — API usage stats for current billing period

## REST API (selected endpoints)

- POST /api/v1/research — Submit M&E research query
- GET /api/v1/brief — Daily executive brief
- GET /api/v1/deep-dive — Deep dive on top story
- GET /api/v1/stocks — M&E stock quotes
- GET /api/v1/usage — Usage and billing stats

Full docs: https://developer.studiosignal.app

## Claude plugin

```bash
/plugin marketplace add vfxprojoe/studiosignal-plugin
/plugin install studio-signal@studio-signal-marketplace
```

Includes MCP tools, M&E domain skills, slash commands (/brief, /research, /stocks, /deep-dive), and kai-analyst agent.

## SDKs

- npm: @studiosignal/sdk
- pip: studiosignal