Back to Browse

Banjo MCP Server

by Shatch
Developer ToolsLow Risk9.0MCP RegistryLocal
Free

Server data from the Official MCP Registry

Self-hosted AI assistant that places real phone calls for you: bookings, reservations, errands.

About

Self-hosted AI assistant that places real phone calls for you: bookings, reservations, errands.

Security Report

9.0
Low Risk9.0Low Risk

Valid MCP server (2 strong, 3 medium validity signals). 1 known CVE in dependencies (0 critical, 1 high severity) Imported from the Official MCP Registry.

4 files analyzed · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

What You'll Need

Set these up before or after installing:

Postgres connection URL. Migrations run on boot.Required

Environment variable: DATABASE_URL

Bearer token MCP clients must send (at least 32 characters, e.g. openssl rand -hex 32).Required

Environment variable: MCP_API_KEY

The name of the person Banjo calls on behalf of.Optional

Environment variable: ASSISTANT_PRINCIPAL_NAME

Public hostname Twilio reaches this server on (no scheme), e.g. a tunnel or reverse proxy.Optional

Environment variable: PUBLIC_HOSTNAME

Voice AI vendor. openai is the one carrying live traffic.Optional

Environment variable: VOICE_AI_PROVIDER

OpenAI API key, for VOICE_AI_PROVIDER=openai or openai-live.Required

Environment variable: OPENAI_API_KEY

Twilio account SID.Optional

Environment variable: TWILIO_ACCOUNT_SID

Twilio auth token.Required

Environment variable: TWILIO_AUTH_TOKEN

The Twilio number Banjo calls from, in E.164 (+15551234567).Optional

Environment variable: TWILIO_PHONE_NUMBER

How Banjo tells you a call's outcome. twilio_sms also needs NOTIFY_TO_PHONE_NUMBER and NOTIFY_FROM_PHONE_NUMBER; pushover needs PUSHOVER_APP_TOKEN and PUSHOVER_USER_KEY.Optional

Environment variable: NOTIFICATION_CHANNEL

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-shatch-banjo": {
      "env": {
        "MCP_API_KEY": "your-mcp-api-key-here",
        "DATABASE_URL": "your-database-url-here",
        "OPENAI_API_KEY": "your-openai-api-key-here",
        "PUBLIC_HOSTNAME": "your-public-hostname-here",
        "TWILIO_AUTH_TOKEN": "your-twilio-auth-token-here",
        "VOICE_AI_PROVIDER": "your-voice-ai-provider-here",
        "TWILIO_ACCOUNT_SID": "your-twilio-account-sid-here",
        "TWILIO_PHONE_NUMBER": "your-twilio-phone-number-here",
        "NOTIFICATION_CHANNEL": "your-notification-channel-here",
        "ASSISTANT_PRINCIPAL_NAME": "your-assistant-principal-name-here"
      },
      "args": [
        "-y",
        "banjo"
      ],
      "command": "npx"
    }
  }
}

Reviews

No reviews yet

Be the first to review this server!