Files
clubber/openspec/changes/archive/2025-11-21-add-graphql-tools/proposal.md
T
gurixandClaude dd772db298 chore: archive add-graphql-tools change
Archive completed change proposal to openspec/changes/archive/.
Updated specs with new GraphQL introspection and MCP tool requirements:

- graphql-api: Added GraphQL Introspection Support requirement
- mcp-integration: Added 3 requirements for GraphQL tools
  - Get GraphQL Schema Tool
  - Execute GraphQL Query Tool
  - Tool Input Schema for GraphQL Execution

All requirements include comprehensive scenarios and are now part
of the active specification.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-21 12:08:58 +01:00

1.2 KiB

Why

The current MCP server provides dedicated tools for member management (list_members, get_member, create_member, update_member). While these work well for basic operations, they are limited for complex tasks that require:

  • Flexible querying with custom field selection
  • Complex filters or relationships (future)
  • Ad-hoc data exploration by AI agents
  • Leveraging GraphQL's full introspection capabilities

AI agents connected via the MCP server should be able to discover the GraphQL schema dynamically and construct their own queries for complex tasks.

What Changes

  • Add get_graphql_schema tool to expose the complete GraphQL schema via introspection
  • Add execute_graphql_query tool to allow AI agents to execute arbitrary GraphQL queries and mutations
  • Update README.md with documentation for the new tools
  • Keep existing dedicated member tools for backward compatibility and simple operations

Impact

  • Affected specs: mcp-integration, graphql-api
  • Affected code: src/mcp_server.py, README.md
  • Breaking changes: None (additive only)
  • The dedicated member tools remain available, providing a simpler interface for common operations
  • AI agents gain flexibility to handle complex queries without requiring new dedicated tools