Hamsa icon

CONNECT APP

Build with Hamsa

AI Models That Master Arabic Dialects

Artificial Intelligence (AI)

  • API key

MCP

Give your agent Hamsa tools

Every Hamsa action is exposed as an MCP tool on Pipedream's remote server. Point a client at it with your end user's ID and Connect resolves that user's Hamsa account for each tool call — you store no tokens.

// 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": "hamsa",
      },
    },
  },
)

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

const { tools } = await mcp.listTools()

// e.g. run Create AI Content:
const result = await mcp.callTool({
  name: "hamsa-create-content",
  arguments: {
    jobId: "Job Id",
    aiParts: ["AI Parts"],
  },
})

SDK

Run Hamsa actions from your backend

Connect a user's Hamsa account once, then run Create AI Content on their behalf from your own code — TypeScript, Python, or plain HTTP.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "hamsa-create-content",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    hamsa: { authProvisionId: "apn_xxxxxxx" },
    jobId: "Job Id",
    aiParts: ["AI Parts"],
  },
})

EVENTS

Hamsa triggers

Event sources your backend can deploy for users and receive through a webhook.

No Hamsa triggers are available yet.

MULTI-APP

Use Hamsa with other popular apps

Most products don't stop at one integration. Pair Hamsa with the other apps your users rely on, and ship use cases that span both.

REFERENCE

App details

Reference metadata for the Hamsa connector in the Pipedream registry.

App slug
hamsa
Authentication
API key
Categories
Artificial Intelligence (AI)
Actions
6
Triggers
0
API proxy
Not available