View as Markdown
Piped icon Spotify icon

MULTI-APP TOOLKIT

Build with Piped + Spotify

Connect a user's Piped and Spotify accounts and expose tools for both apps directly in your product or your agent.
  • Multi-app
  • One MCP session
  • 20 actions
  • 4 triggers
  • Managed auth

MCP

One MCP session, both toolsets

One session gives your product or agent every Piped and Spotify tool at once — connect once, list tools, and call them like any single-app session.

// accessToken: mint a short-lived token with the Connect SDK — see the MCP guide
const transport = new StreamableHTTPClientTransport(
  new URL("https://remote.mcp.pipedream.net/v3"),
  {
    requestInit: {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        "x-pd-project-id": "{project_id}",
        "x-pd-environment": "production",
        "x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
        "x-pd-app-slug": "piped,spotify",
      },
    },
  },
)

const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)

const { tools } = await mcp.listTools()

// One list, both toolsets: Piped and Spotify tools arrive
// together, each keyed by its own app's slug.

// e.g. run Add Items to a Playlist:
const result = await mcp.callTool({
  name: "spotify-add-items-to-playlist",
  arguments: {
    playlistId: "Playlist ID",
    uris: ["Track or Episode URIs"],
  },
})

ARCHITECTURE

One user, two connected accounts

Your user connects each account once, under whatever ID they already have in your product. The two stay independent — either can be revoked on its own — and your code reaches both through that one user.

Your product

external_user_id

{external_user_id}

Pipedream Connect

Managed identity

Auth · tools · routing

Piped

Connected account

Spotify

Connected account

TOOLS

Piped tools

The Piped tools this pairing puts in reach, each one running on your user's own connected account.

View all 0 Piped tools →

Actions

No Piped actions are available yet.

Triggers

No Piped triggers are available yet.

TOOLS

Spotify tools

The Spotify tools this pairing puts in reach, each one running on your user's own connected account.

View all 24 Spotify tools →
x-pd-app-slug
piped,spotify
Primary app
Piped (piped)
Second app
Spotify (spotify)
Authentication
API key + OAuth
Available actions
20
Available triggers
4