# GrainQL > Documentation for GrainQL: the GrainQL Tag, the Analytics Web SDK, the Query API, and the MCP server. - [GrainQL](https://docs.grainql.com/index.md): GrainQL is privacy-first web analytics with Neo, and this site documents its four surfaces. - [Install GrainQL](https://docs.grainql.com/installation.md): This page picks the GrainQL package for your situation and shows the install command. - [Authentication](https://docs.grainql.com/authentication.md): Every GrainQL surface identifies your tenant by its alias, and each one adds its own credential. - [Privacy and consent](https://docs.grainql.com/essentials/privacy-and-compliance.md): This page states what GrainQL stores, how consent changes it, and which safeguards apply. - [Plans and limits](https://docs.grainql.com/plans.md): This page lists the GrainQL plans, what each plan includes, and the limits that a plan sets. - [Troubleshooting](https://docs.grainql.com/troubleshooting.md): This page maps each symptom to its cause and to the action that corrects it. - [Google Tag Manager](https://docs.grainql.com/integrations/gtm.md): Install the GrainQL Tag on your site with a Google Tag Manager custom HTML tag. - [Shopify](https://docs.grainql.com/integrations/shopify.md): Install the GrainQL Tag in your Shopify theme and track cart, checkout, and purchase events. - [WordPress](https://docs.grainql.com/integrations/wordpress.md): Install the GrainQL Tag on WordPress with the GrainQL plugin, or with a script in your theme. - [Script tag](https://docs.grainql.com/quickstart/cdn.md): Install GrainQL Tag with one script tag and send the first event. - [Plain JavaScript, Vue, and Svelte](https://docs.grainql.com/quickstart/vanilla-js.md): Install GrainQL Tag by script tag or npm in any JavaScript framework. - [React](https://docs.grainql.com/quickstart/react.md): Install GrainQL Tag in a React app and track events from components. - [Next.js](https://docs.grainql.com/quickstart/nextjs.md): Install GrainQL Tag in the App Router or the Pages Router and send server-side events with Analytics Web. - [Node.js and servers](https://docs.grainql.com/quickstart/nodejs.md): Send events from a Node.js server or a serverless function with Analytics Web. - [Track an event](https://docs.grainql.com/core/event-tracking.md): The track method sends a named event with properties from the GrainQL Tag or Analytics Web. - [Name events](https://docs.grainql.com/core/event-naming.md): The naming convention gives every custom event the form category_object_action. - [Automatic tracking](https://docs.grainql.com/core/automatic-tracking.md): The GrainQL Tag and Analytics Web collect page views, sessions, heartbeats, and more without code. - [Automatic properties](https://docs.grainql.com/core/event-properties.md): These tables list every property that the GrainQL SDK adds to an event. - [Identify users](https://docs.grainql.com/core/user-identification.md): identify, login, and logout attach your own user ID to the events of both SDKs. - [User properties](https://docs.grainql.com/core/user-properties.md): setProperty stores string attributes on a user for segments and personalization. - [Template events](https://docs.grainql.com/core/template-events.md): Eight Analytics Web methods send a common event with a fixed name and typed properties. - [Tracking checklist](https://docs.grainql.com/guides/analytics-dashboard.md): Ten practices make the events in the dashboard readable and comparable. - [Trackers](https://docs.grainql.com/features/trackers.md): A tracker counts clicks on one element of your site, without a code change. - [Tracks](https://docs.grainql.com/features/tracks.md): A track shows the paths that visitors take from a start event to a goal event, and which events help or hurt. - [Heatmaps](https://docs.grainql.com/features/heatmaps.md): A heatmap shows where visitors click, how far they scroll, and where they get frustrated on a page of your site. - [Mission Control](https://docs.grainql.com/features/mission-control.md): Mission Control shows the conversions of each goal, how they changed, and where they come from. - [Remote configuration](https://docs.grainql.com/core/remote-config.md): Analytics Web reads string values that you change in the dashboard without a deploy. - [Feature flags](https://docs.grainql.com/guides/feature-flags.md): A remote configuration value turns a feature on or off without a deploy. - [A/B tests](https://docs.grainql.com/guides/ab-testing.md): A remote configuration value picks the variant, and two events measure it. - [Personalization](https://docs.grainql.com/guides/personalization.md): User properties and configuration rules return a different value to each user. - [E-commerce tracking](https://docs.grainql.com/guides/ecommerce.md): Send the template events of a shop, from search to purchase, and read the funnel. - [Export and query data](https://docs.grainql.com/guides/query-api.md): Read your events out of GrainQL with the Query API, from the first key to an export. - [React hooks](https://docs.grainql.com/react/overview.md): The React hooks of Analytics Web give components events and configuration values. - [GrainProvider](https://docs.grainql.com/react/grain-provider.md): GrainProvider holds the Analytics Web client that every hook reads. - [useTrack](https://docs.grainql.com/react/use-track.md): useTrack returns a stable function that sends an event from a component. - [useConfig](https://docs.grainql.com/react/use-config.md): useConfig returns one remote configuration value and re-renders when it changes. - [useAllConfigs](https://docs.grainql.com/react/use-all-configs.md): useAllConfigs returns every remote configuration value as one object. - [useGrainAnalytics](https://docs.grainql.com/react/use-grain-analytics.md): useGrainAnalytics returns the Analytics Web client from the provider. - [Configuration options](https://docs.grainql.com/advanced/configuration.md): Lists every configuration option of GrainQL Tag and Analytics Web with its type and default. - [Errors and retries](https://docs.grainql.com/advanced/error-handling.md): Describes what the SDKs do when a request fails and what the caller can catch. - [Security](https://docs.grainql.com/advanced/security.md): States which credential goes where, what the API checks, and what a page must not send. - [Performance](https://docs.grainql.com/advanced/performance.md): States what each Analytics Web call costs and which configuration values change it. - [TypeScript](https://docs.grainql.com/advanced/typescript.md): Lists the exported types of both packages and shows one pattern for each common use. - [Attention quality](https://docs.grainql.com/advanced/attention-quality.md): Lists the rules that decide when Analytics Web counts a section view or a scroll as attention. - [SDK reference](https://docs.grainql.com/api-reference/overview.md): The reference pages list every public method and type of the two GrainQL packages. - [Core methods](https://docs.grainql.com/api-reference/core-methods.md): The core methods send events, identify users, manage consent, and control the lifecycle of both SDKs. - [Configuration methods](https://docs.grainql.com/api-reference/config-methods.md): The configuration methods of Analytics Web read remote configuration values from the cache or from the API. - [Template methods](https://docs.grainql.com/api-reference/template-methods.md): The eight template methods of Analytics Web send a named event with a typed property object. - [React hooks](https://docs.grainql.com/api-reference/react-hooks.md): The React entry of Analytics Web exports one provider, seven hooks, and three consent components. - [Types](https://docs.grainql.com/api-reference/types.md): This page lists every exported type of both GrainQL packages, copied from their declaration files. - [Query API](https://docs.grainql.com/api-reference/query-api/overview.md): The Query API reads events out of GrainQL over HTTPS with an API key. - [Query events](https://docs.grainql.com/api-reference/query-api/query-events.md): POST /{tenantAlias} returns the events that match your filters, one page at a time. - [Count events](https://docs.grainql.com/api-reference/query-api/count-events.md): POST /count/{tenantAlias} returns the number of events that match your filters. - [List event names](https://docs.grainql.com/api-reference/query-api/list-events.md): GET /events/{tenantAlias} returns every distinct event name of the tenant. - [Filters](https://docs.grainql.com/api-reference/query-api/filters.md): A filterSet selects events by property, operator, and value on the query and count endpoints. - [Facts for coding agents](https://docs.grainql.com/agents.md): One page of facts for an agent that writes code against GrainQL. - [MCP server](https://docs.grainql.com/ai-tools/mcp/overview.md): The GrainQL MCP server lets Claude, Cursor, ChatGPT, and any MCP client query your analytics data. - [Claude](https://docs.grainql.com/ai-tools/mcp/claude.md): Add GrainQL as a custom connector in Claude.ai, Claude Desktop, or Claude Code. - [Cursor](https://docs.grainql.com/ai-tools/mcp/cursor.md): Add GrainQL as a remote MCP server in Cursor so the editor agent can query your analytics. - [ChatGPT](https://docs.grainql.com/ai-tools/mcp/chatgpt.md): Add GrainQL as a custom MCP connector in ChatGPT with Developer Mode. - [Tools](https://docs.grainql.com/ai-tools/mcp/tools.md): The twelve tools of the GrainQL MCP server, with their inputs, scopes, and budgets. - [Security and scopes](https://docs.grainql.com/ai-tools/mcp/security.md): This page states what each MCP credential can do, how GrainQL stores tokens, and how you revoke a client. - [Plain JavaScript app](https://docs.grainql.com/examples/vanilla-js.md): Track a static site with GrainQL Tag, from the script tag to consent, in one HTML page. - [React app](https://docs.grainql.com/examples/react.md): Build a React app with the Analytics Web provider, hooks, a flag, a variant, and identified users. - [Next.js app](https://docs.grainql.com/examples/nextjs.md): Run GrainQL Tag in the App Router and send server-side events with Analytics Web. - [E-commerce store](https://docs.grainql.com/examples/ecommerce-store.md): Track a shop from product view to purchase with the Analytics Web template events. - [Authentication flow](https://docs.grainql.com/examples/auth-flow.md): Track signup, login, social login, logout, and password reset with Analytics Web. - [Custom dashboard](https://docs.grainql.com/examples/query-api-custom-dashboard.md): Build a Next.js dashboard that reads event counts and events from the Query API. - [Data export](https://docs.grainql.com/examples/query-api-data-export.md): Export every event of a date range to CSV and JSON with a Node.js script. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.