DatabricksClientMCP Configuration & Schema Registry
The DatabricksClient Model Context Protocol (MCP) configuration provides a validated, machine-readable JSON schema and executable bridge that connects state-of-the-art AI coding assistants — including Claude Desktop, Cursor IDE, Windsurf, Cline, and VS Code Copilot — directly to the DatabricksClient REST API. By leveraging the standardized open Model Context Protocol, AI agents can dynamically discover capabilities, validate input parameters against strict JSON Schemas, and execute live API operations without context switching or manual copy-pasting.
Quick Specs & Integration Summary
Technical Architecture & Protocol Semantics
Under the Model Context Protocol specification, the DatabricksClient configuration functions as an isolated protocol adapter. When an AI agent initializes a session, the client establishes a bidirectional JSON-RPC 2.0 communication channel over standard input/output (stdio) or Server-Sent Events (SSE). During the initial handshake, the server publishes its tool manifest extracted from the DatabricksClient OpenAPI specification (version 2018-04-01).
The DatabricksClient API is a comprehensive RESTful service provided by Microsoft as part of the Azure Resource Manager (ARM) suite, specifically for the Azure Databricks service. This API enables programmatic management of Azure Databricks workspaces, which are fully managed Apache Spark-based analytics platforms designed for big data and AI workloads. Its core capabilities include the full lifecycle management of workspaces—listing all workspaces in a subscription, retrieving details for a specific workspace, creating new workspaces, updating their configurations, and deleting them. The operations are scoped within the hierarchical Azure resource model, allowing for precise resource group-level organization and governance. This API is indispensable for enterprises operating in the Azure cloud, particularly for data engineering teams, data scientists, and platform administrators who need to automate the provisioning, scaling, and governance of Databricks environments. Typical use cases include implementing infrastructure-as-code (IaC) pipelines for workspace deployment, integrating workspace management into custom administrative dashboards, and automating cost control by dynamically adjusting or tearing down non-production environments. When this API is exposed as tools to an AI coding assistant through the Model Context Protocol (MCP), it transforms from a set of static endpoints into a dynamic, conversational interface for cloud infrastructure management. The AI agent gains the ability to understand natural language instructions and translate them into precise, context-aware API calls. This creates a significant value multiplier by dramatically reducing the friction and learning curve for interacting with complex cloud resource APIs. Instead of manually crafting API requests or writing extensive boilerplate scripts, a developer can directly instruct the AI to perform high-level tasks. For example, the AI can serve as an intelligent intermediary that understands the user's intent—such as "spin up a new development workspace"—and knows to call the appropriate `PUT` endpoint with the necessary parameters, like the resource group name and workspace configuration, potentially even suggesting reasonable defaults based on established naming conventions or organizational policies. Practical workflows enabled by this MCP server are both powerful and varied. A developer could instruct the AI agent with commands like: "List all Databricks workspaces in our 'analytics' resource group and summarize their status to identify any that are stopped or in a faulted state." The AI would execute the relevant `GET` call, parse the JSON response, and present a human-readable summary. Another dynamic task could be: "Create a new staging workspace named 'db-staging-eastus' in resource group 'rg-data-dev' using the same SKU as our production workspace, but disable public network access." The agent would first query the production workspace details, extract the SKU, then compose and execute a `PUT` request with the modified configuration. For lifecycle automation, one could say: "Archive the workspace 'db-exploration-old' by applying a tag 'Environment: Archived' and then deleting it after 7 days if not explicitly renewed." The AI could execute the `PATCH` to update tags and schedule a future `DELETE` operation, demonstrating an ability to manage multi-step, stateful processes. Critical to the secure and effective use of this API through an MCP server is robust authentication and adherence to security best practices. While the basic description lists "None" for authentication, in a real-world implementation, this API requires Azure Active Directory (AAD) OAuth 2.0 tokens for authorization, typically acquired via a service principal or user identity with appropriate permissions. The principle of least privilege is paramount; the service principal or user credentials used by the AI assistant must be granted only the specific Azure Role-Based Access Control (RBAC) roles needed for its intended operations, such as "Databricks Contributor" scoped to specific resource groups, rather than broader subscription or contributor roles. Configuration should involve storing secrets like client IDs and client secrets in a secure vault (e.g., Azure Key Vault) and ensuring all API calls are made over HTTPS. Developers setting up this server should also implement thorough logging and monitoring to audit the actions performed by the AI agent, ensuring traceability and accountability for automated infrastructure changes. This architecture guarantees strict process boundary isolation: all sensitive authorization headers and secret tokens remain sandboxed inside the client runtime, never leaking into language model context windows or external logging endpoints.
Hosted Remote Configuration URL
MCP Configuration FileProvide this hosted URL in any client that supports remote MCP schema auto-loading.
https://mcpbridge.org/config/azure-com-databricks.json2. AI Assistant Use Cases & Practical Workflows
Tailored for Data & AnalyticsReal-world execution scenarios demonstrating how LLM agents (Claude 3.7, GPT-4o, Cursor Agent) invoke DatabricksClient tools to automate developer workflows.
1. Schema Introspection & Query Plan Optimization
Query OptimizationAllow AI coding assistants in Cursor or Claude Desktop to inspect live database schemas, identify missing indexes, and generate optimized queries.
"Inspect the table schema using DatabricksClient MCP tools. Analyze index coverage for recent user activity filters and construct an optimized SQL query with EXPLAIN plan recommendations."
2. Real-Time Health & Connection Pool Monitoring
Database ReliabilityDiagnose production latency spikes by checking active connection pool utilization, deadlocks, and slow query execution logs.
"Query DatabricksClient health and operational metrics. Summarize current active connections, identify any slow query bottlenecks exceeding 250ms, and recommend pool sizing tweaks."
3. Automated ETL Validation & Data Pipeline Sync
Data PipelinesExtract recent mutation batches, validate record field types against destination schemas, and output migration statistics.
"Retrieve records modified in the last 24 hours via DatabricksClient. Validate each record schema against our target interface and output a batch migration summary report."
4. Backup Verification & Disaster Recovery Audit
Disaster RecoveryVerify automated snapshot integrity, inspect point-in-time recovery timestamps, and audit compliance retention windows.
"List recent automated snapshot backups in DatabricksClient. Confirm that the most recent snapshot completed successfully within the last 6 hours and report retention metadata."
End-to-End Multi-Step Agent Execution Lifecycle
When an engineer submits a task to Claude Desktop or Cursor, the LLM executes an autonomous 4-phase Model Context Protocol loop:
Schema Introspection
Handshake lists all 7 tools and builds argument validators.
Argument Synthesis
Model extracts parameters from prompt and validates types against OpenAPI rules.
Stdio Execution
Bridge invokes live API with injected local credentials and captures raw HTTP response.
Output Remediation
LLM parses JSON results, handles status codes, and presents synthesized answers.
3. Multi-Client Installation Matrix & Setup Guides
Select your AI assistant below to view exact configuration file paths, JSON installation snippets, and launch commands.
Claude Desktop
claude_desktop_config.json~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.json~/.config/Claude/claude_desktop_config.json{
"mcpServers": {
"azure-com-databricks": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-openapi",
"https://api.apis.guru/v2/specs/azure.com/databricks/2018-04-01/swagger.json"
],
"env": {
"DATABRICKSCLIENT_API_KEY": "your_databricksclient_api_key"
}
}
}
}Cursor IDE
.cursor/mcp.jsonOpen Cursor Settings → Features → MCP Servers, or create .cursor/mcp.json in your project root.
{
"mcpServers": {
"azure-com-databricks": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-openapi",
"https://api.apis.guru/v2/specs/azure.com/databricks/2018-04-01/swagger.json"
],
"env": {
"DATABRICKSCLIENT_API_KEY": "your_databricksclient_api_key"
}
}
}
}Saves as .cursor/mcp.json in the download. Move it to your project root.
VS Code / Cline Extension
cline_mcp_settings.jsonPaste into your Cline extension MCP configuration or Roo Code host settings.
{
"mcpServers": {
"azure-com-databricks": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-openapi",
"https://api.apis.guru/v2/specs/azure.com/databricks/2018-04-01/swagger.json"
],
"env": {
"DATABRICKSCLIENT_API_KEY": "your_databricksclient_api_key"
}
}
}
}Zed Editor & Docker CLI
Zed / DockerDocker container execution command:
docker run -i --rm -e DATABRICKSCLIENT_API_KEY="YOUR_SECRET_VALUE" node:20-alpine npx -y @modelcontextprotocol/server-openapi https://api.apis.guru/v2/specs/azure.com/databricks/2018-04-01/swagger.json
Zed settings context servers JSON:
{
"context_servers": {
"azure-com-databricks": {
"command": {
"path": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-openapi",
"https://api.apis.guru/v2/specs/azure.com/databricks/2018-04-01/swagger.json"
],
"env": {
"DATABRICKSCLIENT_API_KEY": "your_databricksclient_api_key"
}
}
}
}
}Programmatic SDK Integration (TypeScript / Python)
Initialize the DatabricksClient MCP client directly in your backend codebase.
import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
// Initialize DatabricksClient MCP client transport over stdio
const transport = new StdioClientTransport({
command: "npx",
args: ["-y","@modelcontextprotocol/server-openapi","https://api.apis.guru/v2/specs/azure.com/databricks/2018-04-01/swagger.json"],
env: { DATABRICKSCLIENT_API_KEY: process.env.DATABRICKSCLIENT_API_KEY || "YOUR_SECRET_KEY" }
});
const client = new Client(
{ name: "azure-com-databricks-client", version: "1.0.0" },
{ capabilities: { tools: {}, resources: {}, prompts: {} } }
);
async function connectAndRun() {
await client.connect(transport);
const tools = await client.listTools();
console.log("Connected to DatabricksClient MCP Server.");
console.log("Discovered 7 mapped tools:", tools);
}
connectAndRun().catch(console.error);Raw Stdio Schema Definition
schema.jsonFor standalone CLI wrappers, background daemon daemons, or custom script integrations:
{
"mcpServers": {
"azure-com-databricks": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-openapi",
"https://api.apis.guru/v2/specs/azure.com/databricks/2018-04-01/swagger.json"
],
"env": {
"DATABRICKSCLIENT_API_KEY": "your_databricksclient_api_key"
}
}
}
}4. Security, Authentication & Credential Management
Safely configure authentication tokens, isolate execution environments, and implement enterprise security best practices.
Required Environment Keys Reference
| Variable Name | Required | Type | Default | Purpose & Guidance |
|---|---|---|---|---|
| DATABRICKSCLIENT_API_KEY | REQUIRED | Secret Key / Token | None (Set in env) | your_databricksclient_api_key |
Zero-Downtime Token Rotation Protocol
- Generate Secondary Key: Create a new secret API token with identical scopes in your DatabricksClient developer portal.
- Update Client Configuration: Insert the new token inside the
envblock of your MCP client JSON config. - Validate Connection: Issue a test query in Claude or Cursor to ensure handshake and tool calls succeed.
- Revoke Stale Token: Decommission the legacy key on the vendor portal to prevent unauthorized access.
Least-Privilege & Sandboxing Rules
- Read-Only Token Scoping: Whenever your workflow only requires querying data, provision read-only credentials to prevent accidental mutations.
- Local Process Isolation: Stdio transports run in isolated local subprocesses; secret credentials are never sent across the internet to MCP Bridge servers.
- Prompt Injection Defense: AI model responses are sandboxed; verify generated destructive arguments before confirming execution in agent mode.
Enterprise Security Checklist (Mandatory Practices)
- Never commit
claude_desktop_config.jsonor.cursor/mcp.jsoncontaining raw secrets into public GitHub repositories. - Add
.cursor/mcp.jsonand.env.localto your project's.gitignorefile. - Always enforce TLS/HTTPS encryption on outbound network requests initiated by the server process.
5. Tool Parameter Schemas & Natural Language Execution
Mapped OpenAPI operations converted into discrete Model Context Protocol tools with strict JSON-RPC payload validators.
/providers/Microsoft.Databricks/operationsOperations_List
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "azure-com-databricks_get_providers_Microsoft_Databricks_operations",
"arguments": {}
}
}"Use DatabricksClient to execute Operations_List and output the formatted result."
/subscriptions/{subscriptionId}/providers/Microsoft.Databricks/workspacesWorkspaces_ListBySubscription
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "azure-com-databricks_get_subscriptions__subscriptionId__providers_Microsoft_Databricks_workspaces",
"arguments": {}
}
}"Use DatabricksClient to execute Workspaces_ListBySubscription and output the formatted result."
/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Databricks/workspacesWorkspaces_ListByResourceGroup
{
"jsonrpc": "2.0",
"id": 3,
"method": "tools/call",
"params": {
"name": "azure-com-databricks_get_subscriptions__subscriptionId__resourceGroups__resourceGroupName__providers_Microsoft_Databricks_workspaces",
"arguments": {}
}
}"Use DatabricksClient to execute Workspaces_ListByResourceGroup and output the formatted result."
/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Databricks/workspaces/{workspaceName}Workspaces_Get
{
"jsonrpc": "2.0",
"id": 4,
"method": "tools/call",
"params": {
"name": "azure-com-databricks_get_subscriptions__subscriptionId__resourceGroups__resourceGroupName__providers_Microsoft_Databricks_workspaces__workspaceName",
"arguments": {}
}
}"Use DatabricksClient to execute Workspaces_Get and output the formatted result."
/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Databricks/workspaces/{workspaceName}Workspaces_CreateOrUpdate
{
"jsonrpc": "2.0",
"id": 5,
"method": "tools/call",
"params": {
"name": "azure-com-databricks_put_subscriptions__subscriptionId__resourceGroups__resourceGroupName__providers_Microsoft_Databricks_workspaces__workspaceName",
"arguments": {}
}
}"Use DatabricksClient to execute Workspaces_CreateOrUpdate and output the formatted result."
/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Databricks/workspaces/{workspaceName}Workspaces_Delete
{
"jsonrpc": "2.0",
"id": 6,
"method": "tools/call",
"params": {
"name": "azure-com-databricks_delete_subscriptions__subscriptionId__resourceGroups__resourceGroupName__providers_Microsoft_Databricks_workspaces__workspaceName",
"arguments": {}
}
}"Use DatabricksClient to execute Workspaces_Delete and output the formatted result."
/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Databricks/workspaces/{workspaceName}Workspaces_Update
{
"jsonrpc": "2.0",
"id": 7,
"method": "tools/call",
"params": {
"name": "azure-com-databricks_patch_subscriptions__subscriptionId__resourceGroups__resourceGroupName__providers_Microsoft_Databricks_workspaces__workspaceName",
"arguments": {}
}
}"Use DatabricksClient to execute Workspaces_Update and output the formatted result."
6. Interactive Troubleshooting & FAQ Accordion
Diagnose and resolve common JSON-RPC protocol error codes, connection disconnects, and schema refresh issues.
A 401 Unauthorized response indicates that the upstream DatabricksClient API rejected the authentication credential supplied in your MCP client's environment configuration. To resolve this: (1) Verify that your secret token is defined inside the "env" block of claude_desktop_config.json or .cursor/mcp.json rather than hardcoded in the command string. (2) Check whether DatabricksClient requires a prefix such as "Bearer <token>" in the authorization header. (3) Confirm that your API key has not expired and has been granted sufficient least-privilege scopes on the DatabricksClient developer dashboard.
If your MCP client fails to initialize tools for DatabricksClient: (1) Test the bridge launcher command ("npx -y @modelcontextprotocol/server-openapi https://api.apis.guru/v2/specs/azure.com/databricks/2018-04-01/swagger.json") directly inside your terminal or shell to inspect stdout/stderr diagnostic traces. (2) Verify network connectivity to the schema source (https://api.apis.guru/v2/specs/azure.com/databricks/2018-04-01/swagger.json). (3) Ensure Node.js (v18+) is installed and accessible in your system PATH. (4) For authenticated APIs, confirm credentials are configured in your client's "env" mapping rather than command arguments.
MCP clients like Claude Desktop and Cursor query the server's tools list ("tools/list") during startup and cache the resulting JSON Schema for the duration of the application session. If new endpoints or parameters are added to DatabricksClient: (1) Fully quit and restart Claude Desktop (Cmd+Q on macOS or File > Exit on Windows). (2) In Cursor IDE, navigate to Settings > Features > MCP Servers, toggle the DatabricksClient server off and on, or click the refresh icon to re-execute the initialization handshake.
If the AI model hallucinates parameters or fails to invoke a tool automatically: (1) Add explicit system instructions in your project's .cursorrules or Claude project prompt (e.g., "When querying Data & Analytics, always invoke the azure-com-databricks MCP server tools first"). (2) Ensure parameter types match schema specifications (e.g., passing integers as numbers rather than strings). (3) Check that required parameters marked in Section 5 are not omitted from the model's generated payload.
When the DatabricksClient upstream endpoint returns an HTTP 429 Too Many Requests response, the MCP server bubbles the structured error payload back to the AI client over stdio. Modern LLMs like Claude 3.7 and Cursor Agent recognize rate-limiting status codes, inspect the "Retry-After" header if present, and will automatically introduce backoff delays or ask the user before retrying the operation.
The Hosted Config URL (https://mcpbridge.org/config/azure-com-databricks.json) provides a static, remote JSON schema definition that cloud-native MCP clients can fetch over HTTPS for dynamic discovery. In contrast, local stdio configurations execute a local subprocess on your workstation. Local stdio processes offer maximum security because secret API keys remain strictly on your local machine and never transit third-party proxy servers.
Similar Data & Analytics Configurations
Explore related API bridges with ready-to-use Model Context Protocol schemas.
Amazon Comprehend
Data & AnalyticsAmazon Comprehend is a sophisticated natural language processing (NLP) service provided by Amazon Web Services (AWS) that enables developers to extract meaningful insights and analyze the content of text documents at scale. Its core capabilities extend far beyond basic keyword matching, leveraging pre-trained machine learning models to perform complex linguistic analysis. The service can identify the predominant language, dissect sentiment (positive, negative, neutral, or mixed), recognize named entities such as people, places, and organizations, extract key phrases, and perform syntactic analysis to understand parts of speech and sentence structure. Furthermore, it offers specialized features for detecting and redacting personally identifiable information (PII), classifying documents into custom-defined categories, and analyzing sentiment directed at specific entities within text. This makes it a foundational tool for enterprises needing to process vast volumes of unstructured text data, with use cases ranging from customer review analysis, chatbot intent recognition, and content recommendation engines to compliance monitoring and automated document sorting. When exposed as a tool to an AI coding assistant via the Model Context Protocol (MCP), Amazon Comprehend's API becomes a powerful extension of the AI's analytical capabilities. An AI agent can directly invoke these NLP functions without the developer needing to write boilerplate code or manage API calls manually. This integration transforms the AI assistant from a code generator into an active data analyst and workflow automator. For instance, the AI could be instructed to analyze a batch of customer support tickets to identify emerging complaint topics, then generate a Python script that visualizes the sentiment trends over time. It could also assist in building data pipelines by writing code that uses the API to redact PII from documents before storing them in a database, directly addressing compliance requirements like GDPR. The MCP server acts as a bridge, allowing the AI to leverage AWS's scalable NLP infrastructure as a native tool within its problem-solving process. In practice, a developer can instruct the AI agent to perform a variety of dynamic, text-centric tasks. For example, the AI could be told to "scan all new product reviews in this folder, use Amazon Comprehend to detect entities and sentiment, and create a summary report highlighting the most frequently mentioned positive and negative aspects of Product X." To automate content moderation, a developer might request the AI to "write a Lambda function that uses the ClassifyDocument endpoint to filter incoming user comments, flagging any that match a custom 'toxic content' classifier you help me train." For optimizing a search engine, the AI could be tasked with "processing a log of search queries to extract key phrases and dominant languages, then updating our Elasticsearch index to improve query handling." These workflows demonstrate how the AI can chain together API calls and generated code to turn raw text into actionable intelligence, automate repetitive analysis, and build intelligent features into applications. Critical to the secure implementation of this API is the authentication framework. While the basic description may list authentication as "None," all AWS service calls require credentials. Developers must configure their environment with valid AWS IAM (Identity and Access Management) credentials, typically via an access key and secret key, or by assigning an appropriate IAM role if running on an AWS service like EC2 or Lambda. Adherence to the principle of least privilege is paramount; IAM policies should be meticulously scoped to grant only the specific Comprehend actions (e.g., comprehend:DetectSentiment) required for a particular task, and restricted to the specific data resources involved. Furthermore, sensitive text data processed by the API is encrypted in transit (using HTTPS) and at rest. Developers should also be mindful of API rate limits and costs, and consider using batch operations (e.g., BatchDetectSentiment) for efficiency when processing large datasets to minimize both latency and expense.
https://mcpbridge.org/config/amazonaws-com-comprehend.jsonAmazon Kinesis Firehose
Data & AnalyticsAmazon Kinesis Data Firehose is a fully managed service provided by Amazon Web Services (AWS) designed to reliably capture, transform, and load streaming data at scale into AWS data stores and analytics services. Its core capability lies in its ability to handle continuous, high-throughput data streams from millions of sources, including application logs, clickstream data, IoT sensor telemetry, and database change data capture (CDC) streams. The service excels at real-time delivery, allowing users to ingest data and have it routed and delivered to destinations such as Amazon Simple Storage Service (S3) for data lake storage, Amazon OpenSearch Service for real-time log analytics, Amazon Redshift for near real-time business intelligence dashboards, and third-party platforms like Splunk for operational monitoring. Typical enterprise use cases involve building foundational data pipelines for big data analytics, enabling real-time security event monitoring, implementing centralized logging for distributed applications, and powering live dashboards that require sub-second data freshness. It removes the operational burden of managing infrastructure and software for streaming data ingestion, offering features like automatic scaling, data transformation with AWS Lambda, and flexible data backup mechanisms. When exposed as tooling via the Model Context Protocol (MCP) to an AI coding assistant, the Kinesis Data Firehose API provides a powerful interface for dynamic, automated data pipeline management. An AI agent becomes a programmable operator capable of orchestrating the lifecycle of streaming data flows. The value lies in the ability to translate high-level, natural language instructions into precise API operations, dramatically accelerating development and operational workflows. For instance, a developer can instruct the AI to "set up a new delivery stream to route application error logs to S3 with a 5-minute buffering interval and enable GZIP compression," and the AI can construct and execute the `CreateDeliveryStream` call with the appropriate configuration. Similarly, an AI could be tasked with "listing all delivery streams that are currently encrypted," using the `ListDeliveryStreams` and `DescribeDeliveryStreams` endpoints to audit compliance. This turns the AI assistant into a collaborative partner for real-time data architecture, capable of implementing complex configurations, diagnosing stream health issues, and performing routine maintenance tasks on behalf of the developer. In practice, a developer working with an MCP server for Kinesis Firehose can engage in a variety of dynamic, automated workflows. They can instruct the AI agent to perform tasks such as: "Query the last 100 records from the 'app-events-stream' delivery stream and summarize the most common event types to verify data format," utilizing `DescribeDeliveryStream` and potentially interacting with the destination to sample data. To automate infrastructure setup, a command like "Clone the configuration of the production 'analytics-ingestion' stream and create a new, identical stream named 'staging-ingestion' for testing" can be executed by reading the source stream's config and calling `CreateDeliveryStream`. For operational troubleshooting, the AI can be directed to "Check the 'FailedDataWriteCount' metric for all delivery streams and report any with values greater than zero," requiring it to list streams, describe each, and parse the monitoring metrics. Furthermore, tasks like enabling server-side encryption with a new AWS Key Management Service (KMS) key for a specific stream, tagging streams for cost allocation, or temporarily stopping a stream for maintenance are all operations that can be precisely orchestrated through natural language instructions. Security and authentication are paramount when configuring an MCP server for this API. While the API reference itself notes "None" for a specific method, all actual requests to the AWS API must be authenticated using valid AWS credentials, typically an IAM role or user with an access key ID and secret access key. The critical best practice is to apply the principle of least privilege: create a dedicated IAM policy that grants only the specific Firehose permissions required for the intended tasks (e.g., `firehose:DescribeDeliveryStream`, `firehose:PutRecord`) on the specific stream resources (`Resource: "arn:aws:firehose:region:account-id:deliverystream/stream-name"`). Developers must ensure these credentials are securely managed and never embedded in client-side code or exposed in logs. Additional configuration guidelines include enabling server-side encryption with a customer-managed KMS key for all streams handling sensitive data, utilizing VPC endpoints to keep traffic on the AWS network, and configuring data transformation functions with appropriate IAM roles that follow least privilege principles. It is also advisable to set up robust monitoring and alerting on stream metrics like `DeliveryToDestinationSuccess` and `IncomingBytes` to ensure operational health.
https://mcpbridge.org/config/amazonaws-com-firehose.jsonAmazon Kinesis
Data & AnalyticsAmazon Kinesis Data Streams (KDS) is a fully managed, scalable service provided by Amazon Web Services (AWS) designed for real-time ingestion, buffering, and processing of streaming data at massive scale. The Kinesis Data Streams Service API Reference details a comprehensive set of programmatic actions for administering and interacting with Kinesis data streams, which serve as the foundational "plumbing" for real-time data pipelines. Its core capabilities encompass the entire lifecycle of a stream, from creation and configuration to monitoring and deletion. Through these API endpoints, developers and administrators can programmatically create streams with specified shard counts, adjust retention periods for data accessibility, tag streams for cost allocation and organization, manage enhanced monitoring metrics, and control stream consumers for specialized read access. Typical enterprise use cases include real-time application monitoring and log aggregation, live feeds from IoT sensors and devices, real-time analytics on clickstream data, and capturing financial transaction data for immediate processing, fraud detection, or loading into data lakes and warehouses. When exposed as tools via the Model Context Protocol (MCP) to an AI coding assistant like Claude Desktop, Cursor, or Cline, the Kinesis API gains a powerful new interaction paradigm that transforms development workflows. The AI agent can dynamically query, manage, and reason about streaming infrastructure as a natural part of a coding or debugging session. This exposure provides immense value by eliminating context-switching and manual console navigation; a developer can instruct the AI to inspect the configuration of a live stream during a code review, verify that monitoring is enabled before deploying a new producer, or even suggest optimal shard count increases based on current usage patterns described in chat. The AI can act as a knowledgeable co-pilot, translating high-level operational intentions into precise API calls, thereby accelerating development, reducing operational errors, and providing instant access to the state of the streaming environment. Practically, a developer could engage the AI agent in several dynamic, context-rich tasks. For instance, one could instruct, "Check the current shard count and retention period for the 'user-activity-stream' and let me know if it aligns with our expected peak load." The AI would use the DescribeStream or DescribeStreamSummary endpoints to retrieve this information and provide an analysis. Another instruction could be, "Set up enhanced monitoring for CPU and iterator age on the 'transaction-stream' so we can debug those lagging consumers," prompting the AI to call the EnableEnhancedMonitoring action. Furthermore, a developer could automate a common administrative workflow by saying, "Create a new stream named 'analytics-pipeline-q4' with 12 shards and set its retention to 168 hours," leading the AI to execute the CreateStream and IncreaseStreamRetentionPeriod calls in sequence, potentially validating the outcome with a subsequent DescribeStream call. Critical attention to security is paramount when exposing such a potent API through an MCP server. The "None" authentication method listed is a placeholder for the actual AWS Signature Version 4 process; in practice, every API request must be cryptographically signed using credentials (access key and secret key) from an IAM (Identity and Access Management) user or role. Adherence to the principle of least privilege is essential: the IAM entity used by the MCP server should be granted only the specific Kinesis actions required for its intended use (e.g., DescribeStream, PutRecord) via a narrowly scoped IAM policy, avoiding broad administrative permissions like "kinesis:*". Developers should also ensure that the MCP server's credentials are stored securely (e.g., not in plain text configuration files) and that all communication occurs over encrypted channels. Furthermore, enabling server-side encryption (SSE) with AWS Key Management Service (KMS) for sensitive streams adds a vital layer of data protection, and implementing VPC endpoints can restrict traffic to the AWS private network, further hardening the security posture.
https://mcpbridge.org/config/amazonaws-com-kinesis.jsonAWS Kinesis Analytics - Kinesisanalytics
Data & AnalyticsAmazon Kinesis Analytics (version 1) is a managed service provided by Amazon Web Services (AWS) that enables developers to query and analyze streaming data in real time using standard SQL. The API serves as the programmatic interface for creating, configuring, and managing analytics applications that continuously process and analyze data from streaming sources such as Amazon Kinesis Data Streams or Amazon Kinesis Data Firehose. Core capabilities include creating and deleting applications, defining and modifying input sources, configuring output destinations, adding reference data for enrichment, and setting up logging to Amazon CloudWatch for monitoring and debugging. This service is foundational for enterprise use cases requiring real-time operational intelligence, such as fraud detection in financial transactions, live monitoring of IT infrastructure logs, real-time analytics on clickstream data for e-commerce personalization, and operational dashboards that visualize system health metrics as they occur. It transforms raw streaming data into actionable insights with minimal latency, reducing the need for complex batch processing pipelines. When exposed as a toolset via the Model Context Protocol (MCP) to an AI coding assistant, the Amazon Kinesis Analytics API gains significant contextual value. The AI agent can act as a highly efficient operations and development partner, directly manipulating the lifecycle of analytics applications. Instead of a developer manually writing AWS CLI commands or navigating the AWS Management Console, they can issue natural language instructions. The AI, with access to these endpoints, can interpret intent and execute precise API calls to perform tasks like programmatically provisioning a new analytics application for a specific data stream, dynamically adjusting the input processing configuration to handle data format changes, or scaling output resources in response to detected throughput issues. This integration automates routine DevOps tasks, accelerates development cycles, and reduces the cognitive load on engineers, allowing them to focus on higher-level application logic and data modeling rather than infrastructure management. For a practical workflow, consider a scenario where a developer needs to set up a new real-time analytics pipeline for log data. The developer can instruct the AI agent: "Create a new Kinesis Analytics application named 'LogAnalyzer' that ingests data from my Kinesis stream 'app-logs-stream'." The AI would use the CreateApplication and AddApplicationInput endpoints to build and configure the foundation. Subsequently, the developer can refine the pipeline with commands like, "Update the 'LogAnalyzer' application to use a reference data file from S3 to enrich the incoming logs with geo-location data," prompting the AI to call AddApplicationReferenceDataSource. To redirect the analyzed output for archiving, the developer might say, "Send the output from 'LogAnalyzer' to a new Firehose delivery stream for long-term storage," which would trigger an AddApplicationOutput call. This conversational orchestration of the API endpoints enables rapid prototyping and agile modification of real-time data workflows. Critical security and configuration practices must be enforced when setting up an MCP server for this API. Although the API itself relies on AWS Identity and Access Management (IAM) for authentication, the connection between the AI assistant and the API endpoints must be secured. Developers must never hardcode AWS credentials. Instead, the MCP server should be configured to use an IAM role with the principle of least privilege, granting only the specific Kinesis Analytics permissions (e.g., kinesisanalytics:CreateApplication, kinesisanalytics:AddApplicationInput) required for the intended tasks. All API calls should be routed over HTTPS. For enhanced security, the Kinesis Analytics application itself should be configured within a Virtual Private Cloud (VPC) to control network access to its underlying resources. Furthermore, developers should implement thorough error handling in the AI's interaction logic and maintain audit logs of all automated changes to ensure traceability and compliance with operational governance policies.
https://mcpbridge.org/config/amazonaws-com-kinesisanalytics.json