Troubleshooting
Tips for troubleshooting issues with the Nhost MCP server
MCP troubleshooting debugging MCP tools JSON-RPC testing MCPIf you run into issues using the MCP server on your favorite AI service you can try running the tools yourself. Each example below is standalone, so you can copy and run just the one you need.
cloud-graphql-query
Section titled “cloud-graphql-query”echo '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"cloud-graphql-query","arguments":{"query":"{ apps { id subdomain name } }"}},"id":1}' | nhost mcp startgraphql-query
Section titled “graphql-query”echo '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"graphql-query","arguments":{"query":"{ users { id } }","subdomain":"local","role":"admin"}},"id":1}' | nhost mcp startmanage-graphql
Section titled “manage-graphql”echo '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"manage-graphql","arguments":{"body":"{\"type\":\"export_metadata\",\"args\":{}}","subdomain":"local","path":"/v1/metadata"}},"id":1}' | nhost mcp startget-schema
Section titled “get-schema”echo '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"get-schema","arguments":{"subdomain":"local","role":"admin","summary":true}},"id":1}' | nhost mcp startsearch
Section titled “search”echo '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"search","arguments":{"query":"how to enable magic links"}},"id":1}' | nhost mcp startRead a resource
Section titled “Read a resource”echo '{"jsonrpc":"2.0","method":"resources/read","params":{"uri":"schema://nhost-cloud"},"id":1}' | nhost mcp start