Model Context Protocol server for AI assistant integration
buena_list_leads
limit
(optional): Number of leads to return (default: 50, max: 100)offset
(optional): Pagination offset (default: 0)search
(optional): Search term for name/emailcompany
(optional): Filter by company namestatus
(optional): Filter by status (active, inactive, contacted)sort
(optional): Sort field (created_at, updated_at, first_name, last_name)order
(optional): Sort order (asc, desc)buena_create_lead
first_name
(required): Lead’s first namelast_name
(required): Lead’s last nameemail
(required): Valid email addresscompany
(optional): Company namephone
(optional): Phone numberlinkedin_url
(optional): LinkedIn profile URLjob_title
(optional): Job titlelocation
(optional): Location/citynotes
(optional): Additional notestags
(optional): Array of tagscustom_fields
(optional): Custom field data as JSON objectbuena_get_lead
lead_id
(required): Unique lead identifierbuena_update_lead
lead_id
(required): Unique lead identifiercreate_lead
buena_delete_lead
lead_id
(required): Unique lead identifierbuena_list_api_keys
buena_create_api_key
name
(required): Descriptive name for the API keypermissions
(required): Array of permission stringsdescription
(optional): Key descriptionexpires_at
(optional): Expiration date (ISO 8601 format)buena_list_voice_clones
buena_create_voice_clone
name
(required): Descriptive name for the voice clonedescription
(optional): Description of the voice cloneaudio_files
(required): Array of audio file paths or URLs for voice trainingbuena_update_voice_clone
voice_id
(required): Unique voice clone identifiername
(optional): Updated name for the voice clonedescription
(optional): Updated descriptionsettings
(optional): Voice generation settings (stability, clarity, etc.)buena_delete_voice_clone
voice_id
(required): Unique voice clone identifierbuena_generate_voice_preview
voice_id
(required): Voice clone identifier to usetext
(required): Text to synthesize into speechvoice_settings
(optional): Voice generation parametersbuena_send_linkedin_voice_message
profile_url
(required): LinkedIn profile URL of the recipientmessage
(required): Text message contentvoice_settings
(optional): Voice message configuration
voice_id
(required): Voice clone ID to usevoice_text
(required): Text to convert to voice messagevoice_params
(optional): Voice generation parametersbuena_health_check
Variable | Description | Required |
---|---|---|
BUENA_API_KEY | Your Buena.ai API key | Yes |
BUENA_API_URL | API base URL (default: https://api.buena.ai/api/v2) | No |
MCP_SERVER_PORT | Server port (default: auto-assigned) | No |
MCP_LOG_LEVEL | Logging level (debug, info, warn, error) | No |
buena-mcp.config.json
file:
leads:read
- For listing and retrieving leadsleads:write
- For creating and updating leadsleads:delete
- For deleting leads (optional)api_keys:read
- For listing API keysapi_keys:write
- For creating API keys (optional)voice:create
- For creating voice clonesvoice:read
- For listing and retrieving voice clonesvoice:update
- For updating voice clone settingsvoice:delete
- For deleting voice clones (optional)voice:preview
- For generating voice previewslinkedin:voice
- For sending LinkedIn voice messagesError: BUENA_API_KEY not found
Solution:
npx @buena/sdk mcp --log-level debug