Failed introspection with Alchemy / Satsuma subgraph endpoints missing __schema

[jjame21]

Issue

After following the full instructions, I got the following error with an Alchemy / Satsuma subgraph while running the graphclient build command. When using an identical subgraph deployed to The Graph instead, everything worked as according to the README instructions. There may be missing features on Alchemy's endpoints causing this. It appears that the issue may be that Alchemy does not support querying the __schema field. Perhaps it doesn't even exists in those endpoints' data.

Suggestion

It would be good to note this in a message in the readme.

As of 2025-10-29 Alchemy subgraphs do not support introspection with graphclient build due to missing support for __schema field queries

Console Error Output

sensitive data redacted

root@fedora:/app/base# bunx graphclient build

[2025-10-28T21:46:00.058Z] INFO  GraphClient Cleaning existing artifacts

[2025-10-28T21:46:00.079Z] INFO  GraphClient Reading the configuration

[2025-10-28T21:46:00.823Z] INFO  GraphClient Generating the unified schema

[2025-10-28T21:46:02.553Z] ERROR GraphClient - subgraph-name Failed to generate the schema for the source "subgraph-name"

 Failed to fetch introspection from https://subgraph.satsuma-prod.com/REDACTED/REDACTED/subgraph-name/version/v0.0.1-new

-version/api: TypeError: Cannot read properties of undefined (reading '__schema')

    at /app/node_modules/@graphql-mesh/graphql/cjs/index.js:155:36

    at process.processTicksAndRejections (node:internal/process/task_queues:103:5)

    at async Object.getWithSet (/app/node_modules/@graphql-mesh/store/cjs/index.js:174:38)

    at async Promise.allSettled (index 0)

    at async GraphQLHandler.getMeshSourceWithoutFederation (/app/node_modules/@graphql-mesh/graphql/cjs/index.js:385:52)

    at async GraphQLHandler.getMeshSource (/app/node_modules/@graphql-mesh/graphql/cjs/index.js:250:28)

    at async /app/node_modules/@graphql-mesh/runtime/cjs/get-mesh.js:89:28

    at async Promise.allSettled (index 0)

    at async getMesh (/app/node_modules/@graphql-mesh/runtime/cjs/get-mesh.js:84:5)

    at async Object.handler (/app/node_modules/@graphql-mesh/cli/cjs/index.js:308:53)

[2025-10-28T21:46:02.553Z] ERROR GraphClient Error: Schemas couldn't be generated successfully. Check for the logs by running Mesh with DEBUG=1 

environmental variable to get more verbose output.

    at getMesh (/app/node_modules/@graphql-mesh/runtime/cjs/get-mesh.js:123:15)

    at process.processTicksAndRejections (node:internal/process/task_queues:103:5)

    at async Object.handler (/app/node_modules/@graphql-mesh/cli/cjs/index.js:308:53)