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>
1.2 KiB
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_schematool to expose the complete GraphQL schema via introspection - Add
execute_graphql_querytool 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