AWS Data ExchangeMCP Configuration & Schema Registry
The AWS Data Exchange 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 AWS Data Exchange 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 AWS Data Exchange 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 AWS Data Exchange OpenAPI specification (version 2017-07-25).
AWS Data Exchange is a managed service from Amazon Web Services designed to simplify the discovery, subscription, and use of third-party data in the cloud. It acts as a central marketplace and governance layer, enabling data providers to package, sell, and deliver curated datasets, while allowing subscribers to seamlessly integrate this external data into their cloud-based analytics, machine learning, and application development workflows. The core API capabilities revolve around the programmatic lifecycle management of data exchange. Providers can use the API to create and manage data sets, organize them into revisions (versioned snapshots), and define granular access controls. Subscribers leverage the same API to browse available data sets, initiate subscriptions, and then create and manage jobs that handle the automated ingestion, transfer, and preparation of data into their own AWS storage locations like S3 buckets. This facilitates a wide array of enterprise use cases, from financial institutions ingesting real-time market data for risk modeling to retail companies enriching their customer analytics with third-party demographic datasets, all without building complex, bespoke data pipelines. When this API is exposed as a set of tools for an AI coding assistant via the Model Context Protocol, it transforms the AI from a passive code generator into an active, collaborative data operations engineer. The value lies in the AI's ability to directly reason about and manipulate the data exchange lifecycle through natural language instructions. Instead of manually writing scripts to check job statuses or create new data sets, a developer can instruct the AI agent to perform these tasks, drastically reducing cognitive load and context-switching. The AI, acting through the MCP server, becomes a bridge between the developer's intent and the AWS API's concrete implementation. This enables rapid prototyping, automated configuration, and the creation of sophisticated, data-aware development workflows. For instance, the AI can be tasked with auditing all active data subscriptions to generate a compliance report or automatically setting up a new data set and its associated revisions based on a schema provided in a design document, ensuring both speed and consistency in operations. Practical workflow examples demonstrate this synergy. A developer could instruct the AI agent: "Query our active data ingestion jobs and provide a summary of any that have failed in the last 24 hours, including the error messages." The AI would then use the GET /v1/jobs endpoint with appropriate filters, parse the results, and present a human-readable analysis. Another dynamic task could be: "Create a new data set named 'Q4 Financial Indicators', add an initial revision containing the schema definition file located at this S3 URI, and then set up an event action to notify our Slack channel via an SNS topic whenever a new revision is published." The AI would chain together calls to POST /v1/data-sets, POST /v1/data-sets/{DataSetId}/revisions, and POST /v1/event-actions to complete the entire configuration. Furthermore, it could automate subscriber onboarding by taking a list of data set IDs and subscription IDs, then programmatically creating the necessary import jobs for each subscriber to pull data into their environment. Critical authentication and security practices are paramount. Although the API specification may list "None" for authentication, in a production AWS environment, all calls must be authenticated using AWS IAM credentials (access keys or temporary security tokens) and authorized with policies that grant the minimum necessary permissions. Developers setting up the MCP server must configure it to securely manage these credentials, ideally by assuming an IAM role with scoped permissions rather than using long-term access keys. Best practices include implementing the principle of least privilege: creating separate IAM policies for providers (granting permissions for create/update on data sets and revisions) and subscribers (granting permissions for reading data sets and creating jobs), and using conditions in the policy to restrict access to specific data set ARNs or job actions. The MCP server configuration should never hardcode credentials and should leverage environment variables or secure secret management services. All interactions, especially those involving the creation or modification of data sets and jobs, should be logged and audited to maintain governance over the data exchange lifecycle. 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/amazonaws-com-dataexchange.json2. AI Assistant Use Cases & Practical Workflows
Tailored for AI & MLReal-world execution scenarios demonstrating how LLM agents (Claude 3.7, GPT-4o, Cursor Agent) invoke AWS Data Exchange tools to automate developer workflows.
1. Automated Model Evaluation & Benchmark Harness
Model EvaluationSubmit standardized prompt evaluation suites to models, aggregate latency and accuracy metrics, and compile comparative benchmark markdown tables.
"Run our evaluation test suite against AWS Data Exchange. Record completion token latency, context recall scores, and output a formatted markdown performance benchmark table."
2. High-Throughput Embedding & Vector Ingestion
Vector PipelinesBatch process unstructured markdown documentation through embedding endpoints, validate dimensionalities, and push vectors to indexes.
"Generate text embeddings for our updated documentation articles using AWS Data Exchange. Validate that vector dimensions equal 1536 and prepare upsert payloads for the vector database."
3. Fine-Tuning Job Monitoring & Loss Curve Auditing
Fine-Tuning OpsInspect active fine-tuning job telemetry, summarize training loss progression, and alert if validation loss starts diverging.
"Check the current status and training loss progression of our fine-tuning job in AWS Data Exchange. Summarize epoch completion percentages and estimate remaining completion time."
4. Token Quota & Cost Optimization Governance
LLMOps FinOpsTrack organization token burn rates across teams, enforce departmental quotas, and optimize prompt cache hit rates.
"Query organization usage metrics in AWS Data Exchange for the past 7 days. Break down token consumption by model version and highlight optimization opportunities for cached prompts."
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 10 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": {
"amazonaws-com-dataexchange": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-openapi",
"https://api.apis.guru/v2/specs/amazonaws.com/dataexchange/2017-07-25/openapi.json"
],
"env": {
"AWS_DATA_EXCHANGE_API_KEY": "your_aws_data_exchange_api_key"
}
}
}
}Cursor IDE
.cursor/mcp.jsonOpen Cursor Settings → Features → MCP Servers, or create .cursor/mcp.json in your project root.
{
"mcpServers": {
"amazonaws-com-dataexchange": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-openapi",
"https://api.apis.guru/v2/specs/amazonaws.com/dataexchange/2017-07-25/openapi.json"
],
"env": {
"AWS_DATA_EXCHANGE_API_KEY": "your_aws_data_exchange_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": {
"amazonaws-com-dataexchange": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-openapi",
"https://api.apis.guru/v2/specs/amazonaws.com/dataexchange/2017-07-25/openapi.json"
],
"env": {
"AWS_DATA_EXCHANGE_API_KEY": "your_aws_data_exchange_api_key"
}
}
}
}Zed Editor & Docker CLI
Zed / DockerDocker container execution command:
docker run -i --rm -e AWS_DATA_EXCHANGE_API_KEY="YOUR_SECRET_VALUE" node:20-alpine npx -y @modelcontextprotocol/server-openapi https://api.apis.guru/v2/specs/amazonaws.com/dataexchange/2017-07-25/openapi.json
Zed settings context servers JSON:
{
"context_servers": {
"amazonaws-com-dataexchange": {
"command": {
"path": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-openapi",
"https://api.apis.guru/v2/specs/amazonaws.com/dataexchange/2017-07-25/openapi.json"
],
"env": {
"AWS_DATA_EXCHANGE_API_KEY": "your_aws_data_exchange_api_key"
}
}
}
}
}Programmatic SDK Integration (TypeScript / Python)
Initialize the AWS Data Exchange MCP client directly in your backend codebase.
import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
// Initialize AWS Data Exchange MCP client transport over stdio
const transport = new StdioClientTransport({
command: "npx",
args: ["-y","@modelcontextprotocol/server-openapi","https://api.apis.guru/v2/specs/amazonaws.com/dataexchange/2017-07-25/openapi.json"],
env: { AWS_DATA_EXCHANGE_API_KEY: process.env.AWS_DATA_EXCHANGE_API_KEY || "YOUR_SECRET_KEY" }
});
const client = new Client(
{ name: "amazonaws-com-dataexchange-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 AWS Data Exchange MCP Server.");
console.log("Discovered 10 mapped tools:", tools);
}
connectAndRun().catch(console.error);Raw Stdio Schema Definition
schema.jsonFor standalone CLI wrappers, background daemon daemons, or custom script integrations:
{
"mcpServers": {
"amazonaws-com-dataexchange": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-openapi",
"https://api.apis.guru/v2/specs/amazonaws.com/dataexchange/2017-07-25/openapi.json"
],
"env": {
"AWS_DATA_EXCHANGE_API_KEY": "your_aws_data_exchange_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 |
|---|---|---|---|---|
| AWS_DATA_EXCHANGE_API_KEY | REQUIRED | Secret Key / Token | None (Set in env) | your_aws_data_exchange_api_key |
Zero-Downtime Token Rotation Protocol
- Generate Secondary Key: Create a new secret API token with identical scopes in your AWS Data Exchange 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.
/v1/jobs/{JobId}GetJob
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "amazonaws-com-dataexchange_get_v1_jobs__JobId",
"arguments": {}
}
}"Use AWS Data Exchange to execute GetJob and output the formatted result."
/v1/jobs/{JobId}CancelJob
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "amazonaws-com-dataexchange_delete_v1_jobs__JobId",
"arguments": {}
}
}"Use AWS Data Exchange to execute CancelJob and output the formatted result."
/v1/jobs/{JobId}StartJob
{
"jsonrpc": "2.0",
"id": 3,
"method": "tools/call",
"params": {
"name": "amazonaws-com-dataexchange_patch_v1_jobs__JobId",
"arguments": {}
}
}"Use AWS Data Exchange to execute StartJob and output the formatted result."
/v1/data-setsListDataSets
{
"jsonrpc": "2.0",
"id": 4,
"method": "tools/call",
"params": {
"name": "amazonaws-com-dataexchange_get_v1_data_sets",
"arguments": {}
}
}"Use AWS Data Exchange to execute ListDataSets and output the formatted result."
/v1/data-setsCreateDataSet
{
"jsonrpc": "2.0",
"id": 5,
"method": "tools/call",
"params": {
"name": "amazonaws-com-dataexchange_post_v1_data_sets",
"arguments": {}
}
}"Use AWS Data Exchange to execute CreateDataSet and output the formatted result."
/v1/event-actionsListEventActions
{
"jsonrpc": "2.0",
"id": 6,
"method": "tools/call",
"params": {
"name": "amazonaws-com-dataexchange_get_v1_event_actions",
"arguments": {}
}
}"Use AWS Data Exchange to execute ListEventActions and output the formatted result."
/v1/event-actionsCreateEventAction
{
"jsonrpc": "2.0",
"id": 7,
"method": "tools/call",
"params": {
"name": "amazonaws-com-dataexchange_post_v1_event_actions",
"arguments": {}
}
}"Use AWS Data Exchange to execute CreateEventAction and output the formatted result."
/v1/jobsListJobs
{
"jsonrpc": "2.0",
"id": 8,
"method": "tools/call",
"params": {
"name": "amazonaws-com-dataexchange_get_v1_jobs",
"arguments": {}
}
}"Use AWS Data Exchange to execute ListJobs 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 AWS Data Exchange 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 AWS Data Exchange 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 AWS Data Exchange developer dashboard.
If your MCP client fails to initialize tools for AWS Data Exchange: (1) Test the bridge launcher command ("npx -y @modelcontextprotocol/server-openapi https://api.apis.guru/v2/specs/amazonaws.com/dataexchange/2017-07-25/openapi.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/amazonaws.com/dataexchange/2017-07-25/openapi.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 AWS Data Exchange: (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 AWS Data Exchange 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 AI & ML, always invoke the amazonaws-com-dataexchange 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 AWS Data Exchange 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/amazonaws-com-dataexchange.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 AI & ML Configurations
Explore related API bridges with ready-to-use Model Context Protocol schemas.
Openai
AI & MLGenerate text, images, and embeddings. Integrate GPT models and DALL-E into your AI agent.
https://mcpbridge.org/config/openai.jsonAnthropic API
AI & MLAccess Claude AI models for text generation, analysis, and code assistance through the Anthropic API.
https://mcpbridge.org/config/anthropic.jsonOpenAI API
AI & MLThe OpenAI API, developed and maintained by OpenAI, provides programmatic access to a suite of advanced artificial intelligence capabilities centered around large language models (LLMs). Its core functions enable developers to integrate state-of-the-art natural language processing and generation into applications. Key endpoints support text generation (completions, chat completions), content transformation (edits, classifications), semantic analysis (embeddings), and multimodal processing (audio transcriptions and translations). The API serves a broad spectrum of users, from individual developers and startups building conversational agents or content tools to large enterprises automating complex workflows, enhancing customer support, conducting sentiment analysis on large text corpora, or generating synthetic data for training. Use cases span consumer applications like intelligent writing assistants and enterprise-grade solutions for automated document summarization, code generation, and multilingual communication platforms. When exposed as a tool to an AI coding assistant through the Model Context Protocol (MCP), the OpenAI API’s value is significantly amplified. The AI agent gains dynamic, on-demand access to powerful generative and analytical functions without requiring the developer to manually craft intricate API calls or manage complex prompt engineering for each task. This transforms the assistant from a static code-completion engine into an active collaborator that can reason about and manipulate language in real time. For instance, an AI agent within an IDE can directly invoke the completions endpoint to generate boilerplate code from comments, use the embeddings endpoint to identify semantically similar code snippets within a codebase for refactoring suggestions, or call the translations endpoint to automatically localize string literals in an internationalization workflow. This deep integration streamlines the development lifecycle by embedding advanced AI capabilities directly into the authoring environment. Practical workflows enabled by this MCP integration are numerous and dynamic. A developer can instruct the AI to "generate comprehensive unit tests for this Python class by analyzing its public methods and edge cases," leveraging the completions or chat endpoints. Another command could be, "Analyze the sentiment and key topics of these customer feedback logs and produce a summary report," utilizing classifications and embeddings. For data processing tasks, a developer might say, "Translate the error message strings in this logs.txt file from Japanese to English and categorize them by severity," invoking the translations and classifications endpoints in sequence. In collaborative code review, the AI could be directed to "suggest code improvements for this pull request based on best practices for performance and readability," using the edits endpoint to propose specific, contextual modifications. These interactions demonstrate how the MCP server acts as a bridge, allowing the AI to execute sophisticated, multi-step language tasks as part of the developer's natural workflow. Critical to the secure and effective use of this API is proper authentication and configuration, despite the placeholder "None" in the basic metadata. In practice, authentication is mandatory and is handled via API keys (or potentially OAuth for more complex setups). Developers must treat these keys as high-privilege secrets, never hardcoding them in source code or committing them to version control. Best practices include using environment variables or secure secret management services, adhering to the principle of least privilege by creating separate keys with restricted permissions for different development stages or services, and regularly rotating credentials. When configuring an MCP server to interface with the API, it should be set up to inject these credentials securely at runtime. Developers should also implement robust error handling and rate limiting on the client side to manage API quotas and prevent service disruption, ensuring the integration is both secure and resilient.
https://mcpbridge.org/config/openai-com.jsonAmazon CodeGuru Profiler
AI & MLAmazon CodeGuru Profiler is an advanced application performance profiling service provided by Amazon Web Services (AWS). It continuously collects runtime performance data—such as CPU utilization, memory allocation, and thread contention—from live production applications, then analyzes this data using machine learning algorithms to pinpoint performance bottlenecks and inefficiencies. The API serves as the programmatic interface for managing the profiling lifecycle, allowing developers to create and configure profiling groups, adjust agent settings, retrieve performance metrics and findings, and manage notification configurations. Enterprise use cases include optimizing microservice latency in high-traffic systems, reducing cloud compute costs by identifying inefficient code paths, and maintaining application health in continuous deployment pipelines where performance regressions must be detected early. For development teams, it provides actionable insights to guide code optimization efforts based on real-world usage rather than synthetic benchmarks. When exposed as tools via the Model Context Protocol (MCP) to AI coding assistants such as Claude Desktop or Cursor, the CodeGuru Profiler API unlocks a powerful paradigm where an AI agent can directly interact with live performance telemetry. The primary value lies in enabling the AI to contextualize code suggestions with actual runtime behavior. Instead of analyzing static code alone, the AI can query the latest profiling data to understand which functions are consuming the most resources under real load, validate whether a suggested refactor addresses a genuine bottleneck, or even predict the performance impact of a proposed change. This transforms the assistant from a generic code generator into a performance-aware partner, capable of providing recommendations that are not just syntactically correct but are also optimized for the specific performance profile of the deployed application. In a practical workflow, a developer could instruct their AI agent to perform dynamic, performance-informed tasks. For example, the AI could use the GET /profilingGroups/{profilingGroupName} endpoint to retrieve the current status and ARN of a profiling group, then use POST /profilingGroups/{profilingGroupName}/configureAgent to dynamically update agent configuration parameters (like sampling intervals) in response to a detected performance anomaly. An AI agent could query GET /internal/findingsReports to pull the latest list of performance findings, analyze the patterns, and then generate a pull request with code fixes targeted at the top recommendations. Furthermore, the agent could automate notification setup by using POST /profilingGroups/{profilingGroupName}/notificationConfiguration to ensure the team is alerted when CPU utilization exceeds a threshold identified through previous profiling data, creating a closed-loop system for performance management. Developers integrating this API via an MCP server must adhere to critical security and configuration practices. Although the listed authentication is "None," the API fundamentally requires AWS Identity and Access Management (IAM) credentials for all calls, as it is an AWS service. The authentication method "None" in this context likely refers to the lack of a separate API key system, relying instead on standard AWS SigV4 signing. Therefore, security best practices are paramount: apply the principle of least privilege by granting the AI's execution environment only the specific CodeGuru Profiler permissions needed (e.g., profiler:DescribeProfilingGroups, profiler:GetFindingsReport), and avoid wildcard permissions. Credentials should be securely managed via environment variables or an AWS role, never hard-coded. Network security should ensure the AI tool operates within a controlled environment (like a VPC or with strict egress rules) to prevent unauthorized data exfiltration, and all API interactions should be logged and audited for compliance.
https://mcpbridge.org/config/amazonaws-com-codeguruprofiler.json