Set up Cursor

Install the portable Altertable Skills and connect Cursor to the hosted MCP server.

Quick start

1. Open the project where you want to use Altertable.

2. Install the skills with the Agent Skills installer:

   Copy
   npx skills add altertable-ai/skills

3. Choose Cursor when the installer asks which agents should receive the skills.

4. Add the hosted server to .cursor/mcp.json without removing existing servers:

   Copy
   1
   2
   3
   4
   5
   6
   7
   {
     "mcpServers": {
       "altertable": {
         "url": "https://mcp.altertable.ai/mcp"
       }
     }
   }

5. Open Cursor settings → Tools & MCP and enable the Altertable server.

6. Start a new agent session, then ask Cursor to analyze a real workflow:

   Analyze my signup funnel from landing page to account creation.
   Copy

The first Altertable tool call opens OAuth authorization in your browser. Choose the organization and environment Cursor should access, then return to Cursor.

Verify

Ask Cursor:

Use Altertable to list my available catalogs.
Copy

Cursor should call initialize first and then inspect the catalogs.

Tools

• Altertable Skills provide workflows for exploration, SQL, funnels, web traffic, insights, and platform operations.
• Altertable MCP provides governed access to catalogs, queries, insights, discoveries, and tasks.
• The optional Altertable CLI supports shell automation, CI, ingestion, SQL, and structured agent output.

Commit project-scoped skills when every contributor should use the same version. Choose user scope when the installation is only for you.

Choose between Skills, MCP, and the CLI

Use Skills for workflow guidance, MCP for interactive Altertable operations, and the CLI for terminal automation, CI, ingestion, or structured JSON. The CLI is optional and installed separately; Cursor can use it alongside MCP.

Update

Run the installer again when a new Altertable Skills release is available:

Copy
npx skills add altertable-ai/skills

Troubleshooting

• Skills do not appear: confirm that the installer targeted Cursor, then start a new agent session.
• MCP server is disabled: open Cursor settings → Tools & MCP and enable Altertable.
• MCP configuration does not load: confirm that .cursor/mcp.json is valid JSON and restart Cursor.
• Authorization does not finish: complete the browser flow opened by Cursor and choose an organization and environment.
• Wrong environment is connected: remove the Altertable MCP connection and authorize it again with the correct environment.