Skip to content

Kody is live

Watch the launch video — what Kody is, and why it exists.

Watch the videoSee us on Product Hunt
← Public packages

@kody/blandPublic

README.md

70 lines · 2.4 KB · Markdown

@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

  1. In the account secrets UI, approve host api.bland.ai on that secret.
  2. Optional default voice:
import settings from 'kody:@kody/bland/settings'
await settings({ defaultVoice: 'maya' })
  1. 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