MCP Server MCP Server

Model Context Protocol server providing integration management, weather data, AI assistance, and communication tools

Nango integration management • Weather data retrieval • AI-powered Q&A with real-time internet access • Email & SMS messaging • Comprehensive API tooling

✅ Server Active

Available Tools

🌤️

get_weather

Get current weather information for any city worldwide using OpenWeatherMap API. Returns comprehensive weather data including temperature, conditions, humidity, wind, and atmospheric pressure with intelligent location parsing.

Input Parameters
location string required
City name or location to get weather for. For specific regions, use 'City, Country' format.
country string optional
Country name or code to specify which city. Defaults to Canada for ambiguous city names.
units metric | imperial | kelvin optional
Temperature units. Defaults to metric (°C). Options: metric (°C), imperial (°F), or kelvin (K).
Output Format
Weather Display
Formatted weather information including temperature, conditions, humidity, wind speed, cloud coverage, and atmospheric pressure. Also includes raw JSON data for programmatic use.
Example Usage
{ "location": "Toronto", "units": "metric" } { "location": "London, UK", "units": "imperial" } { "location": "Paris", "country": "France" }
Smart Location Features
• Defaults to Canadian cities for ambiguous names (e.g., "London" → London, Ontario)
• Supports province/state specifications (e.g., "London, Ontario")
• Accepts country codes and full country names
• Provides fallback search for better matches
• Handles common ambiguous city names intelligently
🔗

list_integrations

List all available integrations for an organization, showing both connected and available integrations with their connection status. Perfect for managing and viewing integration configurations across your organization.

Input Parameters
organizationId string required
The organization ID to list integrations for. This identifies which organization's integrations to retrieve.
Output Format
Integration List
Comprehensive list showing all available integrations with their connection status, provider information, connection IDs, and connection timestamps. Includes summary statistics and raw JSON data.
Example Usage
{ "organizationId": "org_12345" }
Features
• Shows both connected and available integrations
• Displays connection timestamps and IDs
• Provides summary statistics (X/Y integrations connected)
• Lists provider information for each integration
• Includes raw JSON response for programmatic use
🔍

get_integration

Get detailed information about a specific integration including configuration, OAuth settings, and connection status for an organization. Essential for debugging and managing individual integrations.

Input Parameters
integrationId string required
The integration ID to fetch details for. This is the unique identifier for the specific integration.
organizationId string required
The organization ID to check connection status for. This determines which organization's connection to examine.
Output Format
Integration Details
Complete integration configuration including provider information, OAuth settings, environment variables, webhook URLs, connection status, and connection metadata. Includes both formatted display and raw JSON data.
Example Usage
{ "integrationId": "github_integration", "organizationId": "org_12345" }
Information Provided
• Integration configuration and creation/update timestamps
• OAuth client ID and scopes (secrets are hidden)
• Environment variables and webhook configuration
• Organization-specific connection status
• Connection metadata and timestamps
• Troubleshooting suggestions for disconnected integrations
📋

list_connections

List all connections within an organization, showing connection details, providers, and metadata. Essential for understanding what integrations are connected in your organization and managing organizational access.

Input Parameters
organizationId string required
The organization ID to list connections for. This identifies which organization's connections to retrieve.
Output Format
Connections List
Complete list of all connected integrations within the organization, with connection details, provider information, connection timestamps, and metadata. Includes summary statistics grouped by provider and raw JSON data.
Example Usage
{ "organizationId": "org_12345" }
Features
• Shows all integrations connected in the organization
• Displays connection timestamps and IDs for each connection
• Includes connection metadata (email, name, organization details)
• Groups connections by provider for easy overview
• Provides troubleshooting guidance for organizations with no connections
• Includes raw JSON response for programmatic use
🔍

get_connection

Get detailed information about a specific connection including status, metadata, and end user information. Perfect for debugging connection issues and viewing detailed connection data.

Input Parameters
integrationId string required
The integration ID (provider config key) for the connection.
connectionId string required
The connection ID to retrieve details for.
Output Format
Connection Details
Comprehensive connection information including status, creation/update timestamps, error information, end user details, and metadata. Includes both formatted display and raw JSON data.
Example Usage
{ "integrationId": "hubspot", "connectionId": "user_connection_123" }
Information Provided
• Connection status and health information
• Creation, update, and last fetched timestamps
• Error details and log IDs if any issues exist
• End user information (ID, email, organization)
• Connection metadata and configuration
• Raw connection data for debugging
🤖

ask_question

Ask questions and get AI-powered responses using OpenAI's GPT models via the Vercel AI SDK. Features real-time internet access through the Tavily SDK for current information, news, and up-to-date data. Supports technology, programming, integrations, and general knowledge questions with built-in content filtering for safety and appropriateness. Internet search is automatically triggered for queries about current events, latest news, or real-time information when TAVILY_API_KEY is configured.

Input Parameters
query string required
The question or query to ask the AI assistant. Must be appropriate and helpful. Maximum 1000 characters.
context string optional
Optional context or additional information to help answer the query more accurately.
Output Format
AI Response
Formatted AI response with helpful information, explanations, or guidance. Includes token usage statistics, professional formatting, and internet search status when applicable. When internet access is available, the response will indicate "(with Internet Access)" and show if a search was performed. Responses are filtered for appropriateness and safety.
Example Usage
{ "query": "How do I integrate Nango with my application?", "context": "I'm building a SaaS app that needs to connect to multiple APIs" } { "query": "Explain OAuth 2.0 flow", "context": "For integration management" } { "query": "What are the latest AI developments in 2024?", "context": "Looking for recent breakthroughs and announcements" } { "query": "What is the current weather in San Francisco today?" } { "query": "What are the best practices for API error handling?" }
Safety Features
• Content filtering blocks inappropriate topics and harmful requests
• Focused on technology, programming, and business topics
• No medical, legal, or financial advice
• Professional responses with clear formatting
• Token usage tracking and rate limiting
• Comprehensive error handling and API validation
📧

send_email

Send emails through the Ask Benny agent messaging service. Supports rich email formatting with HTML content, custom subjects, summaries, links, and call-to-action buttons for professional email communications.

Input Parameters
organizationId string required
The organization ID sending the email. This identifies which organization is sending the message.
email string required
The recipient's email address. Must be a valid email format.
message string required
The main content of the email. Can include text or HTML formatting for rich content.
recipientName string optional
The recipient's name for personalized greetings and addressing.
subject string optional
The email subject line. If not provided, a default subject will be used.
summary string optional
A brief summary or preview text for the email that appears in inbox previews.
links array optional
Array of link objects with text, href (URL), and optional description. Used to include reference links or resources.
callToAction object optional
Primary call-to-action button with text and href (URL). Displays as a prominent button in the email.
Output Format
Email Status
Confirmation message with success/failure status and message ID for tracking. Includes error details if the email fails to send.
Example Usage
{ "organizationId": "org_12345", "email": "user@example.com", "recipientName": "John Doe", "subject": "Welcome to Our Service", "message": "Thank you for joining our platform!", "summary": "Your account has been successfully created", "links": [ { "text": "Documentation", "href": "https://docs.example.com", "description": "Learn how to use our service" } ], "callToAction": { "text": "Get Started", "href": "https://app.example.com" } }
Features
• Professional email templates with Ask Benny branding
• Support for HTML content and rich formatting
• Optional call-to-action buttons for engagement
• Link collections for resources and references
• Email tracking with message IDs
• Automatic error handling and retry logic
💬

send_sms

Send SMS messages through the Ask Benny agent messaging service. Supports sending text messages to any phone number with optional custom sender numbers and comprehensive delivery tracking.

Input Parameters
organizationId string required
The organization ID sending the SMS. This identifies which organization is sending the message.
phoneNumber string required
The recipient's phone number. Should include country code for international numbers.
message string required
The SMS message content. Maximum 1600 characters to support long messages (multiple SMS segments).
from string optional
Custom sender phone number. If not provided, uses the default Ask Benny messaging number.
Output Format
SMS Status
Confirmation message with success/failure status and message SID for tracking. Includes detailed error information if the SMS fails to send.
Example Usage
{ "organizationId": "org_12345", "phoneNumber": "+14165551234", "message": "Your verification code is 123456. This code will expire in 10 minutes." } { "organizationId": "org_12345", "phoneNumber": "+14165551234", "message": "Appointment reminder: You have a meeting tomorrow at 2:00 PM", "from": "+14165559999" }
Features
• Support for long messages (up to 1600 characters)
• Automatic message segmentation for long texts
• International phone number support
• Custom sender numbers (when configured)
• Delivery tracking with message SIDs
• Comprehensive error handling and reporting
• Batch sending support through the API

Model Context Protocol Server

Available Tools:

🔗 Integration Management • 🌤️ Weather Data • 🤖 Question Answering • 📧 Email Messaging • 💬 SMS Messaging • 📊 Connection Analytics

📚 MCP Documentation 📋 Clone Template