Voice Monkey ACTION
Trigger Monkey
This action will make an annoucement on your device using any parameters you set. See docs here
- Action
- Writes data
- API key
- SDK
- MCP
IMPLEMENTATION
Call this tool
Connect a user's Voice Monkey account once, then configure and run Trigger Monkey from your backend or agent.
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: "voice_monkey-trigger-monkey",
externalUserId: "{external_user_id}", // any stable ID for this user in your system
configuredProps: {
voice_monkey: { authProvisionId: "apn_xxxxxxx" },
monkey: "Monkey",
announcement: "Announcement text",
},
})
console.log(result)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": "voice_monkey-trigger-monkey",
"configured_props": {
"voice_monkey": { "authProvisionId": "apn_xxxxxxx" },
"monkey": "Monkey",
"announcement": "Announcement text"
}
}'// 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": "voice_monkey",
},
},
},
)
const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)
const { tools } = await mcp.listTools()
// listTools() hands your model this tool's input schema, so it can
// fill the arguments itself:
const result = await mcp.callTool({
name: "voice_monkey-trigger-monkey",
arguments: {
monkey: "Monkey",
announcement: "Announcement text",
},
})SCHEMA
Inputs
Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.
| Property | Type | Description |
|---|---|---|
monkey Monkey | string | This is the ID of the Monkey you want to trigger. Sign in and visit ‘Manage Monkeys’ to create a monkey and view its ID Required |
announcement Announcement text | string | If you want your Alexa device to speak something out loud when you trigger your monkey then add the text to this parameter. You must open the Voice Monkey Skill as the last step of your routine. Required |
chime Chime | string | Add a notification/alarm sound to your routine. Optional |
voice Voice | string | Select from one of the many different voices available for your announcement. Alexa (default) Optional |
audioFileUrl Audio File URL | string | Play an audio file on your Alexa device. Include the full URL including https:// Optional |
backgroundAudioFileUrl Background Audio File URL | string | Play an audio file in the background wishlist Alexa makes your announcement. Include the full URL including https:// Optional |
promptYesResponsePreset Prompt 'Yes' Response Preset Id | string | With prompts you can ask Alexa to ask you a yes/no question (that you include in the announcement of this request) e.g. "Sall I turn on the lights?". If you reply "Yes", the Preset Id you specify here will be triggered. Optional |
promptNoResponsePreset Prompt 'No' Response Preset Id | string | With prompts you can ask Alexa to ask you a yes/no question (that you include in the announcement of this request) e.g. "Sall I turn on the lights?". If you reply "No", the Preset Id you specify here will be triggered. Optional |
imageUrl Image URL (https://) | string | Send an image hosted on a publicly accessible https URL to a screen enabled Alexa device such as an Echo Show. As with announcements, the Alexa routine must open the Voice Monkey Skill as its final action. Optional |
videoUrl Video URL (https://) | string | You can send a video to alexa devices with a screen including the Echo Show. The ‘announcement’ parameter must not be blank. You must open the Voice Monkey Skill as the last step of your routine. Optional |
websiteUrl Website URL | string | Open a website on your screen enabled Alexa device. Include the full URL including https:// Optional |
REFERENCE
Tool details
Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.
- Registry key
- voice_monkey-trigger-monkey
- Version
- 0.0.2
- App
- Voice Monkey
- Authentication
- API key
- Read-only
- No
- Destructive
- No
- Open world
- Yes
- Source
- View on GitHub ↗