Streamable HTTPOAuth 2.1GraphQL

Foozi MCP

Connect your IDE to the Foozi API. One-click install for Cursor and VS Code, with copy-to-clipboard configs for other MCP clients. Authentication uses OAuth via app.foozi.com.br.

Quick install

Registers foozi-graphql at https://mcp.foozi.com.br/mcp

Add to CursorAdd to VS CodeVS Code Insiders

Other clients & copy config

No one-click deeplink — copy JSON or CLI commands for manual setup.

Install tutorial

Step 1. Install from this page
Click Add to Cursor or Add to VS Code above. Your IDE registers the hosted MCP endpoint automatically.
Step 2. Authenticate in your IDE
Open MCP settings in your editor, find foozi-graphql, and start the OAuth connection flow.
Step 3. Sign in at Foozi
When prompted, sign in at https://app.foozi.com.br if you are not already logged in.
Step 4. Approve MCP consent
On the Autorizar acesso MCP page, choose organization, company, role, and token name, then approve.
Step 5. Smoke test
Ask your agent: Use the Foozi MCP get_schema_introspection tool and list the query root fields.

Tools & endpoints

MCP tools
Three tools backed by the real Foozi API after OAuth completes.
execute_graphql

Run GraphQL queries and mutations against Foozi with CASL RBAC enforcement.

get_schema_introspection

Discover types, fields, and available operations from the live schema.

set_auth_context

Switch in-memory token context (hosted MCP prefers OAuth Bearer per request).

Endpoints & services
Hosted MCP and related Foozi infrastructure URLs.

MCP endpoint

https://mcp.foozi.com.br/mcp
/mcpMCP (Streamable HTTP)
/healthHealth check
/.well-known/oauth-protected-resourceOAuth protected resource metadata

OAuth issuer: https://api.foozi.com.br

GraphQL API: https://api.foozi.com.br/graphql

Need help?
Re-authenticate in your IDE, manage access in the Foozi app, or check service connectivity.

Troubleshooting

MCP shows disconnected

Re-authenticate in your IDE's MCP settings (Connect / sign in again).

401 Unauthorized on /mcp

Complete OAuth again — open MCP settings in your editor and reconnect foozi-graphql.

OAuth or connection errors

Confirm you can reach mcp.foozi.com.br and api.foozi.com.br, then sign in again at https://app.foozi.com.br.

Service unreachable

Open the health check link below to verify the MCP host is online.

Useful links

If Foozi provided a registered OAuth clientId (instead of dynamic registration), see the Cursor MCP docs for static client configuration.

Do not commit access tokens or OAuth secrets. Prefer IDE-managed OAuth tokens over static Bearer headers in config files.