@kody/blandPublic

@kody/bland

Intent

Reusable Bland.ai helpers so any Kody-connected agent (Grok Bot, Claude Code, Codex, Cursor, …) can place outbound AI phone calls and read the transcript when the call finishes — the same lifecycle as Dialbot / Bland’s agent quickstart, without requiring a Grok-Bot-only plugin. Auth is a saved API key. Mutations default to a dry-run preview and need confirm: true to run live.

This listing is meant to be forked. After you fork, call ./adapt, save your own blandApiKey, and publish your copy.

Share this package as https://kody.codes/@kody/bland

What it does

• Send an outbound call (task prompt or pathway_id)
• List calls and fetch one call’s status / transcript / analysis
• Stop an in-progress call
• Account check via ./me
• Fork playbook via ./adapt and optional default voice via ./settings

Call lifecycle (important)

Your agent does not stream audio or turn-take mid-call. Bland’s voice agent handles the live conversation. Your agent:

1. Calls send-call → gets call_id immediately
2. Polls get-call until completed is true (about every 5 seconds), or passes a webhook on send so Bland POSTs the finished call
3. Reads the transcript / summary from that result

Same model as Bland’s Agent quickstart and personal-agent MCP tools (create_call + get_call_log).

Prerequisites / setup

1. Create an API key at app.bland.ai/dashboard/settings. Never paste the key into chat.
2. Save it:

https://kody.codes/account/secrets/new?name=blandApiKey&description=Bland.ai%20API%20key%20from%20app.bland.ai%2Fdashboard%2Fsettings&allowedHosts=api.bland.ai&scope=user

3. In the account secrets UI, approve host api.bland.ai on that secret.
4. Optional default voice:

import settings from 'kody:@kody/bland/settings'
await settings({ defaultVoice: 'maya' })

5. Agents: see AGENTS.md for imports and smoke checks.

Coding agents without Kody

Claude Code / Cursor / Codex can also use Bland’s own MCP/plugin (https://api.bland.ai/v1/mcp) directly. This package is for the Kody ecosystem so every Kody agent shares one secret and one API surface.

Adapt this fork

After community_fork, import ./adapt and follow its steps. Put owner-specific defaults in ./settings (package storage) so the official @kody listing does not change.

License

MIT