fonoster

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
2. Returns a list of numbers from Fonoster in a table format (using markdown)
3. Optional inputs:
   • page_size (number): Maximum number of numbers to return
   • page_token (string): Pagination token for next page

4. Returns: List of numbers with their refs, names, and telUrls

5. list_applications

6. Lists applications from Fonoster in a table format (using markdown)
7. Optional inputs:
   • page_size (number): Maximum number of applications to return
   • page_token (string): Pagination token for next page

8. Returns: List of applications with their refs, names, endpoints, creation dates, update dates, and types

9. create_call

10. Creates a call from Fonoster
11. 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

12. Returns: Call creation confirmation with reference ID

13. create_call_batch

14. Creates a batch of calls from Fonoster
15. 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
16. Returns: Batch creation confirmation with reference ID

Prompts

1. create_call_prompt
2. A prompt for creating a call step by step
3. Guides Claude 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:

npx

{
  "mcpServers": {
    "fonoster": {
      "command": "npx",
      "args": [
        "-y",
        "@fonoster/mcp"
      ],
      "env": {
        "WORKSPACE_ACCESS_KEY_ID": "your-workspace-access-key-id",
        "APIKEY_ACCESS_KEY_ID": "your-apikey-access-key-id",
        "APIKEY_ACCESS_KEY_SECRET": "your-apikey-access-key-secret"
      }
    }
  }
}

docker

{
  "mcpServers": {
    "fonoster": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "WORKSPACE_ACCESS_KEY_ID",
        "-e",
        "APIKEY_ACCESS_KEY_ID",
        "-e",
        "APIKEY_ACCESS_KEY_SECRET",
        "fonoster/mcp"
      ],
      "env": {
        "WORKSPACE_ACCESS_KEY_ID": "your-workspace-access-key-id",
        "APIKEY_ACCESS_KEY_ID": "your-apikey-access-key-id",
        "APIKEY_ACCESS_KEY_SECRET": "your-apikey-access-key-secret"
      }
    }
  }
}

Testing with the MCP Inspector

WORKSPACE_ACCESS_KEY_ID="your-workspace-access-key-id" nAPIKEY_ACCESS_KEY_ID="your-apikey-access-key-id" nAPIKEY_ACCESS_KEY_SECRET="your-apikey-access-key_secret" nnpx @modelcontextprotocol/inspector nnode /path/to/fonoster/mods/mcp/dist/index.js

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:

docker build -t fonoster/mcp -f Dockerfile .