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"],
},
})# access_token: mint a short-lived token with the Connect SDK — see the MCP guide
headers = {
"Authorization": f"Bearer {access_token}",
"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",
}
async with streamablehttp_client("https://remote.mcp.pipedream.net/v3", headers=headers) as (read, write, _):
async with ClientSession(read, write) as session:
await session.initialize()
tools = await session.list_tools()
# e.g. run Create AI Content:
result = await session.call_tool("hamsa-create-content", {
"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"],
},
})from pipedream import Pipedream
pd = Pipedream(
client_id="{oauth_client_id}",
client_secret="{oauth_client_secret}",
project_id="{project_id}",
project_environment="production",
)
result = pd.actions.run(
id="hamsa-create-content",
external_user_id="{external_user_id}", # any stable ID for this user in your system
configured_props={
"hamsa": {"authProvisionId": "apn_xxxxxxx"},
"jobId": "Job Id",
"aiParts": ["AI Parts"],
},
)curl -X POST https://api.pipedream.com/v1/connect/{project_id}/actions/run \
-H "Content-Type: application/json" \
-H "X-PD-Environment: production" \
-H "Authorization: Bearer {access_token}" \
-d '{
"external_user_id": "{external_user_id}",
"id": "hamsa-create-content",
"configured_props": {
"hamsa": { "authProvisionId": "apn_xxxxxxx" },
"jobId": "Job Id",
"aiParts": ["AI Parts"]
}
}'TOOLS
Hamsa actions
On-demand operations your product or agent can configure and run on behalf of a connected user.
-
Create AI Content
actionTransform transcribed content into various formats for content marketing. See the documentationWritev0.0.2 -
List Job Id Options
actionRetrieves available options for the Job Id field.Read-onlyv0.0.1 -
List Jobs
actionFetch the list of jobs from Hamsa. See the documentationRead-onlyv0.0.2 -
List Voice ID Options
actionRetrieves available options for the Voice ID field.Read-onlyv0.0.1 -
Synthesize Voice
actionConverts text input into artificial speech using Hamsa. See the documentationRead-onlyv0.0.2 -
Transcribe Video
actionAutomatically transcribe Arabic videos from YouTube URLs or direct links. See the documentationWritev0.0.2
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.
- App slug
- hamsa
- Authentication
- API key
- Categories
- Artificial Intelligence (AI)
- Actions
- 6
- Triggers
- 0
- API proxy
- Not available