didlogic_mcp

Instructions

{
    "destination": [
        {
            "id": 1234455,
            "destination": "12345",
            "priority": 1,
            "callhunt": false,
            "active": true,
            "transport": 5
        }
    ]
}

Implementation Reference

• src/didlogic_mcp/tools/purchases.py:82-126 (handler)

  The core handler function for the 'list_destinations' tool. It takes a DID number and retrieves the list of destinations via the DIDLogic API using the base helper. The @mcp.tool() decorator handles registration.

  @mcp.tool()
  async def list_destinations(
          ctx: Context,
          number: str | int = Field(description="DID Number")
  ) -> str:
      """
          List DID destination.
  
          Args:
              number: DID number in DIDLogic
  
          Returns a JSON object with all did destinations where:
              id: ID of destination
              destination: destination
              priority: priority of selection
              callhunt: flag indicates do destination is part of ring all group
              active: flag indicates is destination enabled or not
              transport: transport of destination where:
                  1 = SIP address destination (ex: 123@example.com)
                  4 = PSTN (phone number) destination (ex: 15551231233)
                  5 = SIP account destination (ex: 12345)
  
          Example:
          ```
          {
              "destination": [
                  {
                      "id": 1234455,
                      "destination": "12345",
                      "priority": 1,
                      "callhunt": false,
                      "active": true,
                      "transport": 5
                  }
              ]
          }
          ```
      """
  
      response = await base.call_didlogic_api(
          ctx,
          "GET",
          f"/v1/purchases/{number}/destinations"
      )
      return response.text

• src/didlogic_mcp/server.py:102-102 (registration)

  Top-level registration call that invokes register_tools on the purchases module, thereby registering the list_destinations tool among others.

  tools.purchases.register_tools(mcp)

• src/didlogic_mcp/tools/purchases.py:121-126 (helper)

  Uses the base.call_didlogic_api helper function to perform the API call for listing destinations.

  response = await base.call_didlogic_api(
      ctx,
      "GET",
      f"/v1/purchases/{number}/destinations"
  )
  return response.text