View as Markdown
Gem icon Telegram icon

MULTI-APP TOOLKIT

Build with Gem + Telegram

Connect a user's Gem and Telegram accounts and expose tools for both apps directly in your product or your agent.
  • Multi-app
  • One MCP session
  • 31 actions
  • 5 triggers
  • Managed auth

MCP

One MCP session, both toolsets

One session gives your product or agent every Gem and Telegram 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": "gem,telegram_bot_api",
      },
    },
  },
)

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

const { tools } = await mcp.listTools()

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

// e.g. run Create Candidate:
const result = await mcp.callTool({
  name: "gem-create-candidate",
  arguments: {
    createdBy: "Created By",
    firstName: "First Name",
  },
})

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

Gem

Connected account

Telegram

Connected account

TOOLS

Telegram tools

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

View all 32 Telegram tools →

Actions top 8 of 28

Triggers

x-pd-app-slug
gem,telegram_bot_api
Primary app
Gem (gem)
Second app
Telegram (telegram_bot_api)
Authentication
API key + API key
Available actions
31
Available triggers
5