io.github.msanchezgrice/talkform (MCP)

Talkform provides local Talkform schemas, bundled interview templates, and configuration validation for AI agents. It is a config-driven audio intake utility that asks for required form fields conversationally, binds structured values into the form, and exports JSON-ready session results. The MCP server portion supports local access to these capabilities.

🛠️ Key Features

Local Talkform schemas
Bundled interview templates
Config validation for AI agents
Exports JSON-ready session results
Works with session/result helpers

🚀 Use Cases

Conversational audio interview intake from predefined field requirements
AI agent workflows that need validated configuration and structured outputs

⚡ Developer Benefits

Config schema support in packages/core
Session and result helper utilities
Agent-friendly CLI in packages/cli
Embeddable React widget (packages/react) and process-local HTTP helpers (packages/http)
MCP access via packages/mcp

⚠️ Limitations

Described scope covers local schemas and tooling; no broader deployment or external integrations are specified in the provided data.

Workspace

apps/web: hosted app for talkform.ai

packages/core: config schema, realtime prompt/tool generation, session/result helpers

packages/react: embeddable React widget

packages/http: process-local transient session and HTTP helpers

packages/cli: agent-friendly CLI

packages/mcp: local MCP schema, template, and config-validation server

docs: markdown documentation rendered in the web app

Environment

OPENAI_API_KEY

OPENAI_REALTIME_MODEL default gpt-realtime-2.1

OPENAI_REALTIME_VOICE default marin

TALKFORM_ENABLE_IMPORT_AI_REFINEMENT optional; only true enables paid AI copy refinement after deterministic import

NEXT_PUBLIC_AUDIOFORM_VENDOR

NEXT_PUBLIC_AUDIOFORM_VENDOR_URL

Transient session APIs and public Realtime client-secret issuance are disabled in hosted production by default. A production deployment needs a durable session store, a distributed rate limiter, and server authentication before those endpoints should be enabled. The current in-memory store and quotas are development/reference implementations; they do not provide cross-instance durability or enforcement.

Machine clients use two matching environment variables:

TALKFORM_API_TOKEN: server-only bearer token accepted by the web API

AUDIOFORM_API_TOKEN: client-side token read by the Talkform CLI

For a controlled deployment, TALKFORM_ENABLE_IN_MEMORY_SESSIONS=true and TALKFORM_ENABLE_PUBLIC_REALTIME=true opt into the reference endpoints. Do not use these flags to represent the current process-local implementations as production-ready infrastructure.

io.github.msanchezgrice/talkform