> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to the Daydream MCP server

The Daydream MCP connector routes your AI agent's tool calls to Daydream's own MCP server through Scalekit. Each user connects their own Daydream access token once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 6 tools.

**Authentication:** Bearer Token
**Categories:** AI, Media
**Tools:** 6: 3 read, 1 write, 2 destructive
**Users sign in with:** Access token
**Built by:** Vendor MCP
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=DAYDREAMMCP)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the Daydream MCP connection

   In **AgentKit > Connections**, create a Daydream MCP connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'daydreammcp'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Daydream MCP:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'daydreammcp_get_songs_left',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "daydreammcp"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Daydream MCP:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="daydreammcp_get_songs_left",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their Daydream MCP server credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'daydreammcp_get_song',
  toolInput: {
    id: '<id>',
  },
  connector: 'daydreammcp',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="daydreammcp_get_song",
    tool_input={
        "id": "<id>",
    },
    connection_name="daydreammcp",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `daydreammcp_get_song`

Check a song · Read-only

Where a song made with create_song stands: its place in line, or, once done, each version's MP3 and WAV links and its five stems' FLAC links (a few seconds after the mix), and any part being made again with redo_stem. A sound effect (kind "sfx") has no stems.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): The song's id from create_song.

Example input: `{"id":"<id>"}`

### `daydreammcp_get_songs_left`

Songs left · Read-only

How many songs the person has made this month and how many they can make (no limit on some accounts), and when the count starts again.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `daydreammcp_list_songs`

Your songs · Read-only

The songs on the person's Daydream account, newest first: each one's id, words, length, tempo and how many versions. Use get_song with an id to play one.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`integer`, optional): How many (default 10).

Example input: `{}`

### `daydreammcp_create_song`

Make a song · Write

Make an original instrumental song from a description: genre, mood, instruments, tempo, what it's for. Returns it queued; the player in the chat shows it rendering and plays it when it's done (about a minute), with MP3 and WAV downloads and its five stems (drums, bass, guitar, keys, other) as FLAC. Where there's no player, get_song gives those links once it's done. Artist names are not allowed and are removed from prompts before generation: describe the sound instead. Royalty-free, for commercial games and videos. It makes sound effects too, with nothing to switch: a description with no music in it ("heavy rain on a tin roof", "a sword clashing against a metal shield") comes back as a sound effect, one take up to 30 seconds with MP3 and WAV and no stems, and its kind is "sfx".

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `prompt` (`string`, required): The music in words, e.g. "a calm village theme with flute and harp", or a sound with no music in it for a sound effect, e.g. "footsteps on gravel".
- `bpm` (`integer`, optional): Tempo; left out, it's chosen from the prompt.
- `duration` (`number`, optional): Length in seconds (default 120).
- `key` (`string`, optional): A note with sharps and major or minor, like "C major" or "F# minor".
- `loop` (`boolean`, optional): A seamless loop, for a game level or a background.
- `seed` (`integer`, optional): Makes the same song again from the same words and settings; left out, a new one each time.
- `variations` (`integer`, optional): How many versions of it to make (default 1). Two count as one song. One of: `1`, `2`.

Example input: `{"prompt":"a calm village theme with flute and harp"}`

### `daydreammcp_redo_stem`

Redo one part · Destructive

Make one stem of a finished song again (new drums, say), with the other four exactly as they are; the mix becomes the new part with the rest. Counts as one song. Takes about a minute; the player shows it. undo_stem puts the old part back.

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `id` (`string`, required): The song's id.
- `stem` (`string`, required): The part to make again. One of: `drums`, `bass`, `guitar`, `keys`, `other`.
- `version` (`integer`, optional): Which version of the song (default 1). One of: `1`, `2`.

Example input: `{"id":"<id>","stem":"drums"}`

### `daydreammcp_undo_stem`

Undo the last redo · Destructive

Put a song's version back to how it was before its last redo_stem: the old part plays again, and the mix with it. Costs nothing. Only the last redo can be undone.

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `id` (`string`, required): The song's id.
- `version` (`integer`, optional): Which version of the song (default 1). One of: `1`, `2`.

Example input: `{"id":"<id>"}`

## Related

Other AI connectors ([all 216](/agentkit/connectors/?category=ai)):

- [Chorus](/agentkit/connectors/chorus/): Scalekit connector, Username and password, 9 tools
- [Gong](/agentkit/connectors/gong/): Scalekit connector, OAuth, 69 tools
- [Jiminny](/agentkit/connectors/jiminny/): Scalekit connector, Access token, 27 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
