channel-info

# Channel Information

Retrieve information about available messaging channels and their capabilities. Prefer MCP tools if available, otherwise use the Conversation API specification. Helps determine which channels can be used to reach contacts.

## Instructions

1. **Understand the user's query:**
   - Are they asking about available channels in general?
   - Are they asking which channels can reach a specific contact?
   - Are they asking about channel capabilities or configuration?

2. **Check MCP availability and use appropriate method:**

   **Option A: Use MCP tools (if MCP Sinch is configured):**
   - First check if MCP Sinch server is available (check MCP server configuration)
   - If MCP is available, use:
     - `list-conversation-apps` to get list of apps and their channel configurations
   - MCP tools handle authentication automatically via environment variables
   - If MCP tool execution fails or MCP is not configured, fallback to Option B

   **Option B: Use Conversation API endpoints (fallback if MCP not available):**
   - **List apps**: `GET /v1/projects/{project_id}/apps` (Operation ID: `App_ListApps`) - Shows configured apps and their channel settings
   - **Get contact**: `GET /v1/projects/{project_id}/contacts/{contact_id}` (Operation ID: `Contact_GetContact`) - Shows which channels are associated with a contact
   - **List contacts**: `GET /v1/projects/{project_id}/contacts` (Operation ID: `Contact_ListContacts`) - Can filter by channel to see contacts on specific channels
   - **Query capability**: `POST /v1/projects/{project_id}/capability:query` (Operation ID: `Capability_QueryCapability`) - Asynchronously checks which channels can reach a contact
   - Authentication: Use Basic Auth or OAuth2 with credentials from environment variables
   - Region: Use CONVERSATION_REGION environment variable (us, eu, or br)
   - Base URL: `https://{region}.conversation.api.sinch.com`

3. **Provide comprehensive channel information:**
   - List all available