Talkform

io.github.msanchezgricePublished by GitHub account msanchezgricev0.1.1Updated Oct 29, 2026

Collect reviewed human answers through hosted handoffs, plus local templates and config validation.

The publisher's own server: Public

Overview

AI-generated overview

Talkform lets an assistant build voice or text interview forms, share private respondent links, and retrieve structured answers.

What you can do
  • List and review public conversational-form templates
  • Prepare a validated form draft from interview questions, with branding and theme colors, without storing it
  • Register a machine-owned project and create hosted handoffs that return a private respondent link and share text
  • Check handoff status and fetch completed structured answers
  • Delete stored handoffs and answers
  • Configure, inspect and disable a webhook for completed handoffs
When to use it
Useful when an assistant needs to collect reviewed human answers — for example intake, onboarding or research interviews — and hand the respondent a link instead of asking questions in chat. Also fits when you want a draft form validated before publishing.
Requirements
Works as a remote endpoint or as a local npm package over stdio. Hosted handoffs require a registered machine project and its API key, or an OAuth account with handoffs:read, handoffs:write or handoffs:delete permissions. Webhooks need an HTTPS endpoint. Self-hosting the full app needs an OpenAI API key and related environment variables.
Before you install
register_agent returns an API key secret once and configure_webhook returns a signing secret once; store them securely. Machine projects get 10 hosted handoffs per day. delete_handoff permanently deletes stored configuration and answers and requires user confirmation. Results expire 7 days after submission. Respondent links and answers are stored on Talkform's hosted service.

Installation

In SourceWeft

  1. Open Talkform in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.msanchezgrice%2Ftalkform/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "talkform": {
      "type": "http",
      "url": "https://www.talkform.ai/api/mcp"
    }
  }
}

README

Talkform

Turn any form into a live audio interview.

Talkform is a config-driven audio intake utility. Products define the fields they need, Talkform asks for them conversationally, binds structured values directly into the form, and exports JSON-ready session results.

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

Core commands

bash
pnpm installpnpm devpnpm buildpnpm typecheck

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.

Source: README.md at commit 78f13d6

Tools

11

talkform.list_templates

List Talkform templates

Lists the public conversational-form templates available for review.

Takes no parameters.

talkform.get_template

Review a Talkform template

Returns one public template as a structured, reviewable conversational form draft.

Parametersidrequired

talkform.prepare_form

Prepare a Talkform draft

Turns interview questions into a validated, shareable form draft. Each promptTitle is the respondent-facing question; fromName, purpose and branding identify the originating product. Optional theme colors use hex values. Returns a draft without storing or publishing it.

ParametersmodethemetitlerequiredfieldsrequiredpurposebrandingfromNamedescriptioninstructions

talkform.register_agent

Create a private agent workspace

Creates a persistent machine-owned project and returns its API key secret once. No email, sign-in, or human identity is created. A UUIDv4 idempotency key identifies registration; retries never replay the secret. Machine projects receive 10 hosted handoffs per day. Voice is available in hosted interviews under shared realtime limits.

ParametersnameenvironmentidempotencyKeyrequired

talkform.create_handoff

Create a hosted interview

Stores a validated voice interview or text interview and returns a private respondent link plus shareText. config.fields[].promptTitle supplies each question; config.branding.fromName and branding.purpose identify the originating product. Omitted mode selects voice; text mode is available. Requires a project API key or scoped OAuth. Optional projectId selects an owned account project; required when the account has several projects. Matching idempotency keys replay the existing handoff.

ParametersconfigrequiredprojectIdidempotencyKeyrequired

talkform.get_handoff

Check interview status

Checks a hosted handoff owned by the authorized project or OAuth account. Requires handoffs:read permission.

Parametersidrequired

talkform.get_result

Retrieve reviewed answers

Returns completed structured answers for an authorized project or OAuth account with handoffs:read permission. Pending results return result_pending. Results expire 7 days after submission. No transcript is returned.

Parametersidrequired

talkform.delete_handoff

Delete a hosted interview

Permanently deletes stored configuration and answers for an authorized project or OAuth account. Requires user confirmation and handoffs:delete permission.

Parametersidrequired

talkform.configure_webhook

Configure a completion webhook

Configures one HTTPS endpoint for completed handoffs in an authorized project. Replaces any active endpoint and returns the signing secret once. Requires handoffs:write permission. Optional projectId selects an owned OAuth account project.

ParametersurlrequiredprojectId

talkform.get_webhook

Get completion webhook

Returns active webhook metadata and recent delivery metadata for an authorized project. Signing secrets are never returned. Requires handoffs:read permission. Optional projectId selects an owned OAuth account project.

ParametersprojectId

talkform.delete_webhook

Disable completion webhook

Disables an authorized project's active webhook and cancels pending deliveries. Requires handoffs:write permission. Optional projectId selects an owned OAuth account project.

ParametersprojectId

Version history

2
  1. v0.1.1LatestOct 29, 2026
  2. v0.1.0Sep 16, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.

Other Myprivacyagent integrations