Skip to main content
Glama
@jambonz/mcp-schema-server

@jambonz/mcp-schema-server

Official
by jambonz

@jambonz/mcp-schema-server

MCP server that provides jambonz verb schemas and documentation to AI agents via the Model Context Protocol.

How It Works

This server exposes the schemas and developer guide from the @jambonz/schema package as MCP tools. AI coding agents can query verb definitions, component types, callback payloads, and the full developer guide without needing local access to the schema files.

Related MCP server: mcp-agno

Tools

Tool

Description

jambonz_developer_toolkit

Returns the full developer guide and schema index. Call this first before writing any jambonz code.

get_jambonz_schema

Fetch the JSON Schema for any verb, component, or callback (e.g. verb:say, component:synthesizer, callback:gather, guide:session-commands).

Usage

stdio transport

npx @jambonz/mcp-schema-server

HTTP transport

npx @jambonz/mcp-schema-server --http --port 3000

Configuration

Claude Code CLI

Add to .mcp.json in your project root:

{
  "mcpServers": {
    "jambonz": {
      "command": "npx",
      "args": ["-y", "@jambonz/mcp-schema-server"]
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "jambonz": {
      "command": "npx",
      "args": ["-y", "@jambonz/mcp-schema-server"]
    }
  }
}

VS Code

Add to .vscode/mcp.json:

{
  "servers": {
    "jambonz": {
      "command": "npx",
      "args": ["-y", "@jambonz/mcp-schema-server"]
    }
  }
}

Remote Hosted Server

A hosted instance is available at:

https://mcp-server.jambonz.app/mcp

To use the remote server in .mcp.json:

{
  "mcpServers": {
    "jambonz": {
      "type": "url",
      "url": "https://mcp-server.jambonz.app/mcp"
    }
  }
}

Development

Local Testing

npm install
npm run build
node dist/index.js              # stdio transport
node dist/index.js --http       # HTTP on port 3000

Release Process

Publishing is handled by GitHub Actions on v* tags. To release:

# After updating dependencies in package.json
npm install
git add -A && git commit -m "chore: update dependencies"

# Bump version and create tag
npm version patch   # or minor/major

# Push commit and tag to trigger publish workflow
git push origin main --tags

License

MIT

Available Tools

4 tools
get_jambonz_schemaA

Get the JSON Schema for a jambonz verb or component. Available: verb:agent, verb:alert, verb:answer, verb:conference, verb:config, verb:deepgram_s2s, verb:dequeue, verb:dial, verb:dialogflow, verb:dtmf, verb:dub, verb:elevenlabs_s2s, verb:enqueue, verb:gather, verb:google_s2s, verb:hangup, verb:leave, verb:listen, verb:llm, verb:message, verb:openai_s2s, verb:pause, verb:play, verb:redirect, verb:rest_dial, verb:room, verb:s2s, verb:say, verb:sip-decline, verb:sip-refer, verb:sip-request, verb:stream, verb:tag, verb:transcribe, verb:transfer, verb:ultravox_s2s, component:actionHook, component:actionHookDelayAction, component:amd, component:auth, component:bidirectionalAudio, component:fillerNoise, component:handoff, component:hangup, component:llm-base, component:recognizer-assemblyAiOptions, component:recognizer-awsOptions, component:recognizer-azureOptions, component:recognizer-customOptions, component:recognizer-deepgramOptions, component:recognizer-elevenlabsOptions, component:recognizer-gladiaOptions, component:recognizer-googleOptions, component:recognizer-houndifyOptions, component:recognizer-ibmOptions, component:recognizer-nvidiaOptions, component:recognizer-openaiOptions, component:recognizer-sonioxOptions, component:recognizer-speechmaticsOptions, component:recognizer-xaiOptions, component:recognizer, component:synthesizer, component:target, component:transferOptions, component:vad, callback:agent-turn, callback:amd, callback:call-status, callback:conference-status, callback:conference-wait, callback:conference, callback:dequeue, callback:dial-dtmf, callback:dial-hold, callback:dial-refer, callback:dial, callback:enqueue-wait, callback:enqueue, callback:gather-partial, callback:gather, callback:listen, callback:llm, callback:message, callback:play, callback:session-new, callback:session-reconnect, callback:session-redirect, callback:sip-refer-event, callback:sip-refer, callback:sip-request, callback:transcribe-translation, callback:transcribe, callback:transfer, callback:tts-streaming-event, callback:verb-status, guide:bridged-call-patterns, guide:conference-monitoring, guide:session-commands, guide:node-sdk

Inputs: name (required).

get_sdk_exampleA

Get full source code for an SDK example. Available: agent, assemblyai-autogenerate-prompt, bedrock-agent, call-recording, conference-supervision, deepgram-voice-agent, dial, echo, elevenlabs-voice-agent, hello-world, ivr-menu, llm-streaming, openai-realtime, queue-with-hold, realtime-translator, retell-hosted, room-play-tone, room-say, room-with-stream, s2s-move-to-room, stream-record, stream-then-room, two-stage-dialer, ultravox-voice-agent, voice-agent

Inputs: name (required).

jambonz_developer_toolkitA

REQUIRED: call this before writing jambonz code. Returns the developer guide (verb model, transports, SDK API, patterns), lists all available schemas, and shows pre-built agent tools (weather, search, calculator, etc.) — check these before implementing custom toolHook handlers.

Inputs: no named parameters.

list_jambonz_toolsA

List the pre-built tools from @jambonz/tools (v0.1.4) for jambonz agent apps, with full parameter schemas. Check here BEFORE hand-rolling a toolHook handler — use a ready-made tool if one fits. Available: calculator, get_datetime, web_search, get_weather, wikipedia.

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool has a distinct purpose: schema retrieval, example code, developer guide, and tool listing. No overlap in functionality.

    Naming Consistency3/5

    Mix of 'get_' prefix for two tools, 'list_' for one, and a noun-phrase name for 'jambonz_developer_toolkit'. Not fully consistent but still readable.

    Tool Count4/5

    4 tools is appropriate for the server's focused purpose of providing jambonz schema, examples, and developer resources. Not too few or too many.

    Completeness4/5

    Covers key developer needs: schema access, examples, developer guide, and pre-built tool listing. No major gaps for its scope.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A MCP server that exposes OpenAPI schema information to LLMs like Claude. This server allows an LLM to explore and understand large OpenAPI schemas through a set of specialized tools, without needing to load the whole schema into the context
      308 npm
      50
      MIT
    • F
      license
      A
      quality
      D
      maintenance
      Provides AI assistants with real-time access to the AGNO framework documentation by enabling them to browse, search, and fetch documentation pages. This server allows users to query information about AGNO's Agents, Teams, and Workflows directly through MCP-compatible clients.
      16
      -
    • F
      license
      A
      quality
      C
      maintenance
      A read-only MCP server that exposes Automeli's public API documentation (v2 canonical, v1 frozen) to LLMs via fetch and cache over www.automeli.com artifacts. It enables listing, searching, and retrieving endpoints, OpenAPI specs, error explanations, code snippets, and end-to-end flow guides.
      7
      -