@kieksme/swetrix-admin-mcp

@kieksme/swetrix-admin-mcp

MCP server for the Swetrix Admin API — 34 tools for managing projects, funnels, annotations, views, and organisations.

Note: All tools require a valid SWETRIX_API_KEY. This server performs write operations — use with care.

Installation

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "swetrix-admin": {
      "command": "npx",
      "args": ["-y", "@kieksme/swetrix-admin-mcp"],
      "env": {
        "SWETRIX_API_KEY": "your-api-key",
        "SWETRIX_API_BASE_URL": "https://analytics.example.com"
      }
    }
  }
}

Claude Code

claude mcp add swetrix-admin -e SWETRIX_API_KEY=your-key -e SWETRIX_API_BASE_URL=https://analytics.example.com -- npx -y @kieksme/swetrix-admin-mcp

Environment variables

Variable	Required	Description
SWETRIX_API_KEY	Yes	Your Swetrix API key (Account Settings → API keys)
SWETRIX_API_BASE_URL	No	Custom API base URL for self-hosted Swetrix (default: https://api.swetrix.com)

Tools

Projects

Tool	Description
swetrix_list_projects	List all projects for the authenticated user
swetrix_get_project	Get details for a single project
swetrix_create_project	Create a new project
swetrix_update_project	Update project name, settings, or configuration
swetrix_delete_project	Delete a project permanently
swetrix_pin_project	Pin a project to the top of the dashboard
swetrix_unpin_project	Unpin a project
swetrix_assign_project_org	Assign a project to an organisation

Funnels

Tool	Description
swetrix_list_funnels	List all funnels for a project
swetrix_create_funnel	Create a new conversion funnel with ordered steps
swetrix_update_funnel	Update funnel name or steps
swetrix_delete_funnel	Delete a funnel

Annotations

Tool	Description
swetrix_list_annotations	List all annotations for a project
swetrix_create_annotation	Add a dated annotation to the traffic timeline
swetrix_update_annotation	Edit an annotation's text or date
swetrix_delete_annotation	Delete an annotation

Views

Tool	Description
swetrix_list_views	List saved dashboard views for a project
swetrix_get_view	Get a specific saved view
swetrix_create_view	Create a new saved view with filters and settings
swetrix_update_view	Update a saved view
swetrix_delete_view	Delete a saved view

Organisations

Tool	Description
swetrix_list_organisations	List all organisations the user belongs to
swetrix_get_organisation	Get details for a specific organisation
swetrix_create_organisation	Create a new organisation
swetrix_update_organisation	Update organisation name or settings
swetrix_delete_organisation	Delete an organisation
swetrix_invite_org_member	Invite a user to an organisation by email
swetrix_update_org_member	Change a member's role within the organisation
swetrix_remove_org_member	Remove a member from an organisation

Example prompts

• "List all my Swetrix projects."
• "Create a new project called Marketing Site."
• "Add a funnel for the checkout flow: /cart → /checkout → /thank-you."
• "Annotate project abc123 on 2025-01-15 with Launched new homepage."
• "Invite [e-mail] to organisation my-org as a viewer."

License

GPL-3.0-only — see LICENSE