← Explore all mcp servers

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.

Upstream setup instructions ↗

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.

  1. Configure an AWS profile limited to the target AppSync resources and region.
  2. Launch without --allow-write and inspect the available read operations.
  3. 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.

  1. 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

  2. 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

  3. 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

  4. https://github.com/awslabs/mcp/blob/8840003820a78dd018561d55c7ab12fcdd708464/README.md

    Supports: summary, install, configExample, access, limitations, bestFor, review, compatibility, transports, license

  5. Applicable licence ↗Checked

    https://github.com/awslabs/mcp/blob/8840003820a78dd018561d55c7ab12fcdd708464/LICENSE

    Supports: license

  6. 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

Evidence & Ask