Skip to content
DocumentationAgent setup
Agent setup
Other agents

Set up other agents

Use this guide when the agent is not Claude Code, Codex, or Cursor. The portable installer adds Altertable Skills only. Add the hosted MCP server separately when the client needs live catalog and query access.

Quick start

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

  2. Install the portable skills:

    npx skills add altertable-ai/skills

  3. Add a streamable HTTP MCP server named altertable at https://mcp.altertable.ai/mcp. See MCP for transport and authorization details.

  4. Start a new agent session so it discovers the skills and MCP server.

  5. Ask the agent to analyze a real workflow:

    Analyze my signup funnel from landing page to account creation.

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

Verify

Ask the agent:

Use Altertable to list my available catalogs.

The agent 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, findings, and tasks.
  • The optional Altertable CLI supports shell automation, CI, ingestion, SQL, and structured agent output.

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; the agent can use it alongside MCP.

Update

Re-run the installer when a new Altertable Skills release is available:

npx skills add altertable-ai/skills

Troubleshooting

  • Skills do not appear: start a new agent session after installation or update.
  • MCP tools do not appear: add https://mcp.altertable.ai/mcp in the client and reconnect. The skills installer does not register the server.
  • Authorization does not finish: complete the browser flow opened by the client and choose an organization and environment.
  • Wrong environment is connected: remove the Altertable MCP connection and authorize it again with the correct environment.