Export nana800 analytics data through the MCP server

What the MCP server does in analytics

The server has six tools for lists and data export.

• analytics_orgs_list: organizations you are a member of.
• analytics_projects_list: projects of an organization.
• analytics_event_types_list: event names of a project.
• analytics_export_create: starts an export of project events, the events of one user or the users list.
• analytics_export_status: the export status and the file link.
• analytics_exports_list: the 20 latest exports.

The server does not put event rows into the answer to the assistant, only the status and the file link. Another 15 tools build charts and dashboards, see the guide to charts through AI. The other tools of the server are for nana800 automation schemes.

How to connect it

You need Node.js 18 or newer and a personal nana800 API key, which you create or copy in the account settings at cloud.nana800.io/settings. The key acts as you, so keep it only in the assistant settings, never in the code of a site. For Claude Desktop add the server to claude_desktop_config.json and restart the app. In Cursor the same block goes into ~/.cursor/mcp.json.

{
  "mcpServers": {
    "nana800": {
      "command": "npx",
      "args": ["-y", "nana800-mcp-server"],
      "env": { "MCP_API_KEY": "your_personal_api_key" }
    }
  }
}

In Claude Code one command adds the server: claude mcp add nana800 -e MCP_API_KEY=your_key -- npx -y nana800-mcp-server. The account must be a member of the analytics organization whose data you want to export.

What a request looks like

Write the task in plain words, for example: "Export the signup_completed events of the Landing project for October to CSV with a semicolon". The assistant finds the organization and the project, starts an export filtered by the event and the period, waits until it is ready and sends the file link.

A filter can hold up to 20 event types, conditions on their properties, and a user selection by properties and performed events. The conditions are the same as in the web app: equals, does not equal, contains, does not contain, greater than, less than, is set, is not set. Time is given in ISO 8601 with a time zone.

Formats and export limits

An export through the MCP server works like the Export button in the web app.

• CSV in UTF-8 with a , or ; delimiter, or JSON Lines with one object per line.
• Up to 1,000,000 rows per file. With more rows the file is cut and marked.
• The file link lives 15 minutes, and asking for the status again gives a new one. The file is kept for 7 days.
• An organization runs one export at a time and up to 10 an hour. Exports started with an API key, including through the MCP server, run at most once every 10 minutes.
• The file is served compressed: a browser saves a plain file, and from a terminal use curl --compressed.

What it is handy for

An export through an assistant saves time when the data is needed in a spreadsheet or another tool. For example, a weekly sheet of sign-ups by source, a list of users with a certain property for the sales team, or a look at raw events when a chart number raises questions. The assistant can analyze the file after it downloads it.