AWS DATA SERVICES / AWS Labs
AWS Labs AppSync
Inspects AppSync APIs and optionally creates GraphQL APIs, data sources, resolvers, API keys and related resources.
“A Model Context Protocol (MCP) server for AWS AppSync that enables AI assistants to manage and interact with backend APIs.”
01 / THE REASONING
Why this made the selection.
- Specialized publisher integration with documented IAM and data access boundaries.
- Inspect AppSync API topology before proposing a resolver or data-source change.
- The README creates and inspects AppSync GraphQL APIs, data sources, and resolvers, but only after an explicit write flag.
- The default is read-only, and the README tells the operator to back up data before enabling writes.
02 / THE REVIEW RECORD
What we actually inspected.
Source review has boundaries.
A clear record is more useful than a “safe” badge.
Material inspected
- src/aws-appsync-mcp-server/README.md
- src/aws-appsync-mcp-server/pyproject.toml
- src/aws-appsync-mcp-server/awslabs/aws_appsync_mcp_server/server.py
- Root README.md and LICENSE
- LICENSE
Our findings
- The parser defaults allow_write to false and the write_operation decorator checks the shared permission state before calling the handler.
- The server manages AppSync APIs, data sources, resolvers, functions, and schemas through the caller's AWS profile.
- Without --allow-write it stays read-only. The listed create tools are blocked and return a permission error.
- The README does not treat write mode as safe by default. It says to grant least privilege, take a backup, and validate instructions before execution. Its licence sentence is Apache License, Version 2.0.
Not established by this review
- Server startup, authentication, live tool execution and security isolation were not tested.
- Published package/container parity with a source revision and hosted implementation internals were not tested.
- The server was not started and its tools were not called.
- A pin does not verify transitive dependencies.
- No tools/list or tool call was made.
The review applies to the material and revision named here. A newer upstream release can change its behavior.
03 / PUT IT TO WORK
Connect a server deliberately.
DOCUMENTED COMMAND
uvx awslabs.aws-appsync-mcp-server@latest Copying does not execute this command. It may retrieve a newer version than the reviewed source.
- Configure an AWS profile limited to the target AppSync resources and region.
- Launch without --allow-write and inspect the available read operations.
- If creation is required, separately authorize write enablement and review authentication modes, data-source roles and resulting endpoints.
Before you start
- Python 3.10 or newer, uv/uvx and an MCP client that can launch a local stdio process.
- An AWS account, configured credentials and access to the intended region and service resources.
Documented configuration example
Use the client and authentication context described in the setup guidance. Configuration formats vary between hosts.
{
"mcpServers": {
"awslabs-appsync": {
"command": "uvx",
"args": [
"awslabs.aws-appsync-mcp-server@latest"
],
"env": {
"AWS_PROFILE": "YOUR_RESTRICTED_PROFILE",
"AWS_REGION": "us-east-1"
}
}
}
} 04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
https://github.com/awslabs/mcp/blob/8840003820a78dd018561d55c7ab12fcdd708464/src/aws-appsync-mcp-server/README.md
Supports: summary, install, configExample, access, limitations, bestFor, review, compatibility, transports, license
https://github.com/awslabs/mcp/blob/8840003820a78dd018561d55c7ab12fcdd708464/src/aws-appsync-mcp-server/pyproject.toml
Supports: summary, install, configExample, access, limitations, bestFor, review, compatibility, transports, license
https://github.com/awslabs/mcp/blob/8840003820a78dd018561d55c7ab12fcdd708464/src/aws-appsync-mcp-server/awslabs/aws_appsync_mcp_server/server.py
Supports: summary, install, configExample, access, limitations, bestFor, review, compatibility, transports, license
https://github.com/awslabs/mcp/blob/8840003820a78dd018561d55c7ab12fcdd708464/README.md
Supports: summary, install, configExample, access, limitations, bestFor, review, compatibility, transports, license
- Applicable licence ↗Checked
https://github.com/awslabs/mcp/blob/8840003820a78dd018561d55c7ab12fcdd708464/LICENSE
Supports: license
https://github.com/awslabs/mcp/blob/8840003820a78dd018561d55c7ab12fcdd708464/src/aws-appsync-mcp-server/awslabs/aws_appsync_mcp_server/decorators.py
Supports: summary, install, configExample, access, limitations, bestFor, review, compatibility, transports, license