Fonoster MCP Server

Fonoster MCP Server

MCP Server for the Fonoster API, enabling MCP clients to interact with Fonoster's telephony services. This module is part of the Fonoster open-source project. For more information about the project, please visit https://github.com/fonoster/fonoster.

Tools

1. list_numbers
   • Returns a list of numbers from Fonoster in a table format (using markdown)
   • Optional inputs:
     • page_size (number): Maximum number of numbers to return
     • page_token (string): Pagination token for next page
   • Returns: List of numbers with their refs, names, and telUrls
2. list_applications
   • Lists applications from Fonoster in a table format (using markdown)
   • Optional inputs:
     • page_size (number): Maximum number of applications to return
     • page_token (string): Pagination token for next page
   • Returns: List of applications with their refs, names, endpoints, creation dates, update dates, and types
3. create_call
   • Creates a call from Fonoster
   • Required inputs:
     • from (string): The number to call from
     • to (string): The number to call to
     • app_ref (string): The reference to the application to use for the call
     • metadata (object): Metadata to be sent to the application
   • Returns: Call creation confirmation with reference ID
4. create_call_batch
   • Creates a batch of calls from Fonoster
   • Required inputs:
     • from (string): The number to call from
     • to_array (array): The numbers to call to
     • app_ref (string): The reference to the application to use for the call
     • metadata (object): Metadata to be sent to the application
   • Returns: Batch creation confirmation with reference ID

Prompts

1. create_call_prompt
   • A prompt for creating a call step by step
   • Guides an MCP client through the process of:
     • Asking the user for the number or numbers to call if not already provided
     • Offering a list of available numbers using the list_numbers tool
     • Asking for the application name and finding its reference
     • Creating a call using the create_call or create_call_batch tool depending on the user's request

Setup

Usage with Claude Desktop

Add the following to your claude_desktop_config.json:

If you are logged in to the command-line tool, simply run fonoster mcp:configure --client claude to configure the server.

npx

docker

Testing with the MCP Inspector

Troubleshooting

If you encounter authentication errors, verify that:

1. Your Fonoster credentials are correct
2. The environment variables are properly set
3. You have the necessary permissions to access the Fonoster API

Build

Docker build: