Aila Model Context Protocol (MCP)

Connect Claude directly to your Aila call transcripts using the Model Context Protocol. Give Claude read-only access to your calls, transcripts, and insights for powerful AI-assisted analysis and workflow automation.

Overview

The Aila MCP server enables Claude to:

List your calls - Browse and search through your call library
Read call transcripts - Access full conversation transcripts in multiple formats
Retrieve call metadata - Get call details, participants, duration, and more

This integration is perfect for:

Analyzing call patterns and trends
Creating custom reports from call data
Automating follow-up tasks based on call content
Building AI workflows that reference specific calls
Extracting insights across multiple conversations

Installation

Claude Desktop (Recommended)

Claude Desktop provides the easiest setup experience with OAuth authentication -- no API keys required.

Step 1: Open Connectors Settings

Open the Claude Desktop application
Navigate to Settings
Select Connectors (or Cowork)

Connectors Settings

Step 2: Add Custom Connector

Scroll to the bottom and click "Add custom connector"
A dialog will appear

Add Custom Connector

Step 3: Configure Aila

Enter the following details:

Name: Aila
Server URL: https://app.aila.fyi/api/mcp
Leave the Advanced Settings (OAuth Client ID / Secret) blank

Click "Add" to save.

Step 4: Authorize Connection

Find Aila in your connectors list
Click "Connect"

Connectors Overview

You'll be redirected to the Aila authorization page
Sign in with your Aila credentials

OAuth Authorization

Click "Authorize" to grant read-only access to your call transcripts

Step 5: Start Using

Return to Claude Desktop and start querying your calls:

Show me my last 10 calls from Aila

Using the Aila MCP

Once connected, you can interact with your Aila data naturally in Claude.

Example Prompts

List Recent Calls:

Show me my last 10 calls from Aila

Analyze Specific Call:

Read the transcript from my call with John Smith on February 5th

Extract Insights:

Summarize the key action items from my sales calls this week

Compare Calls:

Compare the objections raised in my last 3 demos

Generate Reports:

Create a report of all calls where the prospect mentioned budget concerns

Follow-up Automation:

For each call from yesterday, draft a personalized follow-up email

Available MCP Tools

The Aila MCP exposes two tools to Claude:

`list_calls`

List recent calls from your Aila workspace. Returns call IDs, contact names, dates, and durations.

Parameters:

page (optional): Page number for pagination (default: 1)
limit (optional): Results per page (default: 20, max: 50)
search (optional): Search by contact name

Returns:

Found 42 calls (showing page 1 of 3):

- **John Smith** (2/10/2026, 15min) — ID: `call_abc123` [completed]
- **Sarah Johnson** (2/9/2026, 8min) — ID: `call_def456` [completed]
- **Acme Corp** (2/8/2026, 22min) — ID: `call_ghi789` [completed]
...

Example Usage:

List my last 10 calls
Show me calls with "Acme" in the contact name

`get_call_transcript`

Retrieve the full transcript for a specific call. Use list_calls first to find the call ID.

Parameters:

call_id (required): The unique identifier for the call (from list_calls)
format (optional): Transcript format (default: identified)
- identified: Transcript with speaker names (e.g., "John Smith: Hi there...")
- diarized: Transcript with speaker labels (e.g., "Speaker 1: Hi there...")
- raw: Plain text transcript without speaker identification

Returns: Full transcript with speaker labels based on the selected format. The tool automatically falls back through formats if the requested format isn't available: identified → diarized → raw.

Example Usage:

Get the transcript for call_abc123
Show me the transcript for my call with John Smith (use identified format)
Read the transcript from call_def456 in raw format

Use Cases

Sales Enablement

Coaching Analysis:

Analyze my team's discovery calls and identify common areas for improvement

Best Practice Extraction:

Review our top-performing calls and create a talk track template

Objection Handling:

Show me how our best reps handle pricing objections

Customer Success

Health Score Analysis:

Review calls with customers who churned and identify warning signs

Feature Requests:

Extract all feature requests mentioned in customer calls this month

Sentiment Tracking:

Analyze the sentiment of our quarterly business reviews

Research & Insights

Theme Identification:

What are the most common pain points mentioned across all calls?

Competitive Intelligence:

List all mentions of competitors and their products

Market Research:

Summarize what customers are saying about our pricing model

Workflow Automation

CRM Updates:

For calls missing next steps in the CRM, extract action items from transcripts

Meeting Prep:

Before my call with Acme Corp, summarize our previous conversations

Documentation:

Create customer success playbooks based on successful onboarding calls

Privacy & Security

Data Access

Read-Only: The MCP has read-only access to your call data
No Modifications: Cannot create, update, or delete calls
Workspace Scoped: Only accesses calls from workspaces you have permissions for

Authentication Methods

OAuth (Recommended):

Secure authorization flow
No API keys to manage
Easy to revoke access
Token expiry for added security

API Key:

Useful for CLI tools and automation
Keep secure and never commit to version control
Can be revoked anytime in Settings > API Keys

Best Practices

Only Connect Trusted Clients: Only add the Aila MCP to applications you trust
Review Permissions: Understand what data the MCP can access
Regular Audits: Periodically review connected applications
Disconnect When Not Needed: Remove the connector if you're not actively using it

Troubleshooting

Connection Issues

"Unable to connect to Aila"

Verify the URL is exactly: https://app.aila.fyi/api/mcp
Check your internet connection
Try disconnecting and reconnecting
Ensure your Aila account is active

OAuth Authorization Fails:

Check that you're using valid Aila credentials
Verify your account has call data access
Try clearing browser cache and re-authorizing
Contact support if the issue persists

No Calls Returned

"I don't see any calls" or "No calls found"

Confirm your Aila workspace has recorded calls
The list_calls tool only shows completed calls (not in-progress)
If using search parameter, try removing it to see all calls
Verify workspace permissions
Check pagination - you might be on a page beyond your total results

Transcript Not Available

"Cannot retrieve transcript"

Ensure the call has finished processing
Check that the call has a transcript (not all calls do)
Verify the call_id is correct
Some very old calls may have archived transcripts

API Key Issues (CLI Tools)

"Unauthorized" or "Invalid API Key"

Verify your API key is correct
Check that the key hasn't been deleted or expired
Ensure the AILA_API_KEY environment variable is set
Try creating a new API key in Settings > API Keys

Advanced Configuration

Batch Processing

For analyzing many calls, use pagination efficiently:

Approach 1: Iterate through pages

List my calls page by page:
- Get page 1 (20 calls)
- Analyze key themes
- Get page 2
- Continue until all calls are analyzed

Approach 2: Targeted analysis

For each of my last 20 calls:
- Extract prospect company names
- Identify their primary pain point
- Note their budget range
- Create a summary table

Best Practice: Process calls in batches of 10-20 to avoid overwhelming Claude's context window with too many transcripts at once.

Integration with Other Tools

Combine the Aila MCP with other Claude connectors:

Aila + Gmail:

Find calls where we promised to send pricing,
then draft follow-up emails with our latest pricing

Aila + Notion:

Create a Notion database of key calls with links to recordings

Aila + Linear:

Extract product feedback from customer calls and create Linear tickets

FAQ

Q: What's the difference between OAuth and API key authentication? A: OAuth (via the web interface) is recommended for most users - it's more secure and easier to manage. API key authentication is useful for CLI tools and automation scripts.

Q: Can I use the MCP to modify or delete calls? A: No, the MCP is read-only. It can only list and read call transcripts, not modify or delete them.

Q: How do I revoke access to the MCP? A: For OAuth: Go to Settings > Connections in your Aila dashboard and disconnect the MCP integration. For API keys: Delete the API key from Settings > API Keys.

Q: What happens if I exceed the rate limit? A: The MCP will return an error. Wait a few seconds and try again. Contact support if you need higher rate limits.

Q: Can multiple people in my organization use the MCP? A: Yes, each user should connect the MCP to their own Claude account. They'll only have access to calls they have permissions to view in Aila.

Q: Does the MCP work with all call types? A: Yes, the MCP works with calls from all sources (Google Meet, Zoom, Teams, OpenPhone, manual uploads, etc.) as long as they have transcripts.

Q: Which client should I use? A: Claude Desktop is recommended for most users due to its easy OAuth setup. Use CLI tools with API keys if you need automation or don't use a desktop client.

Known Limitations

Current limitations of the Aila MCP:

Call Limit: Maximum 50 calls per query (use pagination for more)
Pagination: Results are paginated - use the page parameter to access additional calls
Transcript Formats: Some calls may not have all three transcript formats available
- The tool automatically falls back to available formats: identified → diarized → raw
Call States: Only completed calls are returned by list_calls
Real-time Access: New calls may take 1-2 minutes to appear via MCP after processing completes
Search Limitations: The search parameter only searches contact names, not transcript content

Getting Help

If you encounter issues with the Aila MCP:

Check this documentation for troubleshooting steps
Verify your Aila account settings
Review the Changelog for recent updates
Contact Aila support:
- Email: support@aila.fyi
- Include: Account email, description of issue, screenshots, error messages

Next Steps

Now that you've connected the Aila MCP:

Explore Call Library to understand your call data structure
Review Custom Datasets for structured data extraction
Check out Call Quality for QA checklist automation
Learn about Coaching workflows you can augment with Claude