Grafbase
Grafbase is a platform that accelerates the development of GraphQL APIs, offering features like edge caching, unified data access, and seamless integration with popular authentication strategies.
Verdict
Common use cases
- Rotate API keys after a security incident
- Review schema checks during pull request review
- Disable MCP servers for maintenance windows
- Delete stale extension configs from chat
- Audit who modified production graph settings
Integration
- Vendor
- Grafbase
- Category
- developer-tools
- Auth
- API_KEY
- Tools
- 19
- Composio slug
grafbase
Tools
- Delete Extensiondestructive
Tool to delete an extension configuration. Use after confirming the extension_id to remove the extension.
- Delete Grafbase API Keydestructive
Tool to delete an existing API key. Use after confirming the key ID to revoke access.
- Delete Grafbase Audit Logdestructive
Tool to delete a specific Grafbase audit log entry. Note: As of current Grafbase public documentation, there is no documented API to delete audit logs programmatically. This action will attempt a best-effort REST DELETE to `/audit-logs/{id}
- Delete Grafbase Schemadestructive
Tool to delete a Grafbase schema. Use when you need to remove a specific schema from the registry after confirming its ID.
- Delete MCP Serverdestructive
Tool to delete a Grafbase MCP server configuration by its unique ID. Use after confirming the server ID to remove an existing MCP server.
- Delete Schema Checkdestructive
Tool to delete a Grafbase schema check. Use when you need to remove a specific schema check by its ID after reviewing the registry.
- Disable MCP server
Tool to disable the Model Context Protocol server. Use when you need to turn off MCP via API after it has been enabled.
- Enable Grafbase MCP Server
Tool to enable the Model Context Protocol (MCP) server for a Grafbase project. Use when you need to activate MCP support; if the API endpoint is not supported, this returns guidance for enabling via configuration.
- Get Federated Schema
Tool to retrieve the composed federated graph schema. Use after deploying your federated graph when you need the full SDL.
- Get Grafbase Audit Log
Tool to retrieve a specific Grafbase audit log entry. Use after confirming the audit log ID exists.
- Get Grafbase Schema Check
Tool to retrieve the result of a schema check by its ID. Use when you need to inspect a specific schema check after running a check via CLI or API.
- Get Subgraph Schema
Tool to retrieve the GraphQL SDL of a specific subgraph. Use after confirming the subgraph name to inspect its schema.
- List API Keys
Tool to list all API keys for a project. Use after authenticating with a valid token to retrieve the project’s API keys.
- List Extensions
Tool to list all extensions configured for a Grafbase project. Use after confirming project access when retrieving configured extensions programmatically.
- List Grafbase Audit Logs
Tool to list all audit logs for a project. Use when you need to retrieve historical events (up to 90 days). Note: As of current Grafbase public documentation, there is no documented API to list audit logs programmatically. This action will
- List Grafbase Schema Checks
Tool to list all Grafbase schema checks for a project. Use when you need to review past schema validation runs.
- List Grafbase Schemas
Tool to list all Grafbase schemas. Use when you need to retrieve all schemas in the registry.
- List Grafbase Subgraphs
Tool to list published subgraphs in a branch. Use when you need to retrieve endpoints of all subgraphs for a given branch.
- List MCP Servers
Tool to list all MCP servers configured for a project. Use when you need to retrieve existing MCP server configurations.
Setup
Setup guide
- 11. In Switchy, open the Space where you want Grafbase available and click the integrations panel. 2. Search for Grafbase and click Connect. 3. You'll be prompted to paste an API key—generate one in your Grafbase project settings under API Keys, copying the full token. 4. Paste the key into Switchy and click Authorize. 5. Switchy confirms the connection and lists the 19 tools now available. 6. To test, type '@Grafbase list all API keys for my project' in the Space—if you see a response listing keys or confirming none exist, the integration is live. 7. From now on, any message starting with '@Grafbase' will invoke the MCP's tools, so your team can manage schemas, keys, and servers without leaving the conversation.
What teammates see: by default, memories from Grafbase are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Spaces have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
List All API Keys
@Grafbase list all API keys for my project and show their creation dates and last-used timestamps.Open in a Space →
Delete Unused Extension
@Grafbase delete the extension with ID ext_abc123 and confirm it no longer appears in the registry.Open in a Space →
Check Recent Schema Changes
@Grafbase show me the five most recent schema checks and highlight any that failed validation.Open in a Space →
Enable MCP Server
@Grafbase enable the MCP server for project proj_xyz789 and return the endpoint URL once it's live.Open in a Space →
Revoke Compromised Key
@Grafbase delete the API key with ID key_def456 and confirm it can no longer authenticate requests.Open in a Space →
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@grafbase list all active API keys for our production graph and show when each was last used
Found 4 active API keys for your production graph: 1. 'ci-deploy-key' (created 2024-01-15, last used 2 hours ago) - Full access 2. 'frontend-prod' (created 2024-02-01, last used 12 minutes ago) - Read-only 3. 'analytics-service' (created 2024-02-10, last used 3 days ago) - Read-only 4. 'admin-backup' (created 2023-11-20, never used) - Full access The 'admin-backup' key hasn't been used in over 3 months. Consider rotating or removing unused keys for security.
This example shows Grafbase's key management capabilities. Requires API_KEY auth with admin scope to list keys across the project. The MCP can surface security hygiene issues like stale credentials, but cannot determine if a key is actually needed—coordinate with your team before revoking access.
@grafbase delete the schema check from yesterday's failed CI run, then create a new check for the branch 'feature/user-profiles'
Deleted schema check 'chk_8x2mq9' from the failed CI run (2024-03-14 16:42 UTC). Created new schema check for branch 'feature/user-profiles': - Check ID: chk_9p4fn1 - Status: In progress - Comparing against: main branch schema - Validating: Breaking changes, composition errors, deprecated field usage The check will complete in ~30 seconds. You'll receive a webhook notification if breaking changes are detected.
Demonstrates Grafbase's schema validation workflow for federated graphs. Deleting a check is permanent and removes its history from the registry—useful for cleaning up noise from aborted CI runs. Schema checks run asynchronously; the MCP confirms creation but doesn't wait for results.
@grafbase review our audit logs from the past week and summarize any unusual extension or MCP server configuration changes
Reviewed 47 audit log entries from March 8-15, 2024. Key findings: **Extension changes (3 events):** - March 12: 'auth-validator' extension updated by sarah@team.com (config change: added new OAuth provider) - March 14: 'rate-limiter' extension deleted by deploy-bot (automated cleanup) **MCP server changes (2 events):** - March 10: MCP server enabled for project 'api-gateway' by admin@team.com - March 13: MCP server 'mcp_5x8kl' disabled by system (health check failure) The automated MCP disable on March 13 is unusual—typically indicates connectivity issues. Check server logs for that timeframe.
Showcases how the AI can synthesize Grafbase audit data to surface operational anomalies. Note that Grafbase's audit log API may not support programmatic deletion (per tool description), so this is read-only analysis. Useful for post-incident review or compliance reporting, but audit retention policies are set at the account level.
Use-case deep-dives
When Grafbase MCP makes schema checks a team habit
A product team with 8 backend engineers ships 3-5 GraphQL schema changes per week. Without automation, schema reviews happen in PR comments and breaking changes slip through. The Grafbase MCP gives your AI assistant direct access to schema checks, audit logs, and extension configs—so standup conversations shift from 'did anyone review the schema?' to 'Claude, show me failed checks from yesterday and flag the breaking ones.' The MCP's 19 tools cover the full lifecycle: create checks, delete stale schemas, revoke API keys when contractors leave. This works until your schema registry hits 200+ versions or you need custom governance rules—at that threshold, you're writing your own tooling anyway. If your team merges schema changes daily and wants AI-native guardrails, Grafbase MCP turns schema governance into a Slack thread instead of a Jira ticket.
Revoking Grafbase keys without opening the dashboard
A 3-person startup hires contractors for a 6-week build, grants them Grafbase API keys for local dev, then needs to revoke access when the contract ends. The Grafbase MCP's Delete API Key and audit log tools let you handle this in Switchy: 'Claude, list all keys created in the last 60 days, then revoke the ones tagged contractor-Q1.' The AI cross-references audit logs to confirm which keys were actually used, so you're not blindly deleting. This scenario assumes you're already tagging keys at creation—if your key hygiene is messy, the MCP can't infer intent from names like 'test-key-final-v2.' The win is speed: offboarding moves from a 15-minute dashboard hunt to a 90-second AI conversation. If you onboard and offboard external devs more than twice a quarter, this MCP pays for itself in saved context-switching.
Keeping staging and prod MCP servers in sync
A 5-engineer team runs Grafbase in staging and production, each with its own MCP server config. After a few sprints, the configs diverge—staging has debug extensions enabled, prod is missing a schema check that staging relies on. The Grafbase MCP's Enable/Disable MCP Server and Delete Extension tools let you audit and reconcile: 'Claude, compare MCP server settings between staging and prod, then disable the debug extension in staging to match prod.' The AI reads both environments' configs, flags the diff, and executes the changes in sequence. This assumes you have API keys scoped per environment and you're comfortable letting the AI write to prod (if not, use Switchy's approval gates). The boundary: if your team ships to more than 3 environments or has complex RBAC, the MCP's flat tool list gets unwieldy—you'll want Terraform or a custom CLI. For 2-3 environments and weekly deploys, this MCP keeps config drift from becoming a post-mortem footnote.
Frequently asked
What does the Grafbase MCP let Switchy do?
It connects your Grafbase GraphQL backend to Switchy so your team can manage schemas, API keys, extensions, and audit logs without leaving the workspace. You can enable or disable MCP servers, delete schema checks, and review configuration changes — all through natural language prompts instead of switching to the Grafbase dashboard.
Do I need admin access to connect Grafbase?
Yes. You'll need a Grafbase API key with permissions to read and modify project resources — schemas, extensions, audit logs, and MCP server settings. If your key only has read access, you'll see data but won't be able to delete keys or disable servers. Generate the key in your Grafbase project settings before connecting.
Can the Grafbase MCP deploy new GraphQL schemas?
No. It can delete existing schemas and schema checks, but it doesn't push new schema definitions or run deployments. For schema changes, use the Grafbase CLI or dashboard. The MCP is for managing what's already deployed — reviewing audit logs, revoking API keys, and cleaning up old configurations.
Why use this instead of the Grafbase CLI?
The CLI is faster for scripted workflows. The MCP is better when your team needs to check "who deleted that API key last week" or "is the MCP server still enabled" without context-switching. You can ask Switchy in plain English and get answers pulled from audit logs and live config, which the CLI doesn't surface conversationally.
Who on the team should connect Grafbase?
Whoever owns your Grafbase project and has the API key. Usually that's a backend lead or DevOps engineer. Once connected, anyone in the Switchy workspace can query schemas or audit logs, but only the person who connected it can revoke the integration. Plan your access accordingly if multiple people need admin control.