How to Use the Wakapi (WakaTime Alternative) MCP in Windsurf

Q: Is there a limit to how many projects I can list with Wakapi (WakaTime Alternative) and Windsurf?

The listprojects tool handles project tracking. The limits are defined by the server's backend capacity, not by your client connection. It’s built for scaling.

Know your coding metrics instantly with Windsurf.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Wakapi (WakaTime Alternative) MCP to Windsurf

Create your Vinkius account to connect Wakapi (WakaTime Alternative) to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Wakapi (WakaTime Alternative) with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Get User Statistics via MCP Server

The `get_stats` tool pulls concrete coding statistics for any user. It doesn't just say you worked here; it gives the raw numbers—lines of code, time spent, and activity counts. Windsurf uses these stats to build out full reports automatically. When you set a goal, your agent runs `get_stats` first, giving you an immediate picture of where the bottlenecks are.

Detailed Activity Summaries for Windsurf

Need more than just numbers? Use `get_summaries` to pull a deep dive into activity. This gives context—it shows *what* you were working on and over what period. Because your agent runs multi-step actions, it grabs this detailed summary data and presents it in one cohesive flow. You never have to ask for the next piece of information.

Manage Projects with Wakapi (WakaTime Alternative) on Windsurf

Start by listing all tracked projects using `list_projects`. This tool gives you a clean, current overview of every repo or work area monitored by the system. Tracking multiple client initiatives is simple. The MCP Server helps your agent manage this context across different tools in Windsurf, keeping all project scope details right where they belong.

Setup guide

Set up Wakapi (WakaTime Alternative) MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Wakapi (WakaTime Alternative) MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Wakapi (WakaTime Alternative) payment history." If connected, Cascade will call the Wakapi (WakaTime Alternative) tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "wakapi-wakatime-alternative-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Wakapi. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Wakapi (WakaTime Alternative) now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Wakapi (WakaTime Alternative) MCP in Windsurf

It connects directly through the MCP Server. When you set a goal, your agent talks to Wakapi using structured tool calls (`get_stats`, etc.). It's all automated, no manual steps needed.

Yes. While designed for IDE use, the underlying MCP Server architecture supports headless execution. This means you can pipe the results of the `get_stats` tool into a script running outside your local machine.

The server primarily handles structured coding activity metrics, including user IDs, project names, and timestamps. The agent uses this metadata to build out your final report.

Absolutely. Because the MCP Server is an open standard, it lets any compatible AI client connect. You can layer this data on top of other services your agent connects to.

The `list_projects` tool handles project tracking. The limits are defined by the server's backend capacity, not by your client connection. It’s built for scaling.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript