How to Use the Wakapi (WakaTime Alternative) MCP in LangChain
Build multi-step agents that analyze your coding habits using LangChain.
Works with every AI agent you already use
…and any MCP-compatible client
Connect Wakapi (WakaTime Alternative) MCP to LangChain
Create your Vinkius account to connect Wakapi (WakaTime Alternative) to LangChain and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.
Determine user metrics with `get_stats`
The `get_stats` tool pulls raw coding statistics for a specified user. This lets the agent calculate specific metrics, like time spent per language or most active days. You can chain this output: first, use `list_projects` to narrow down which projects' stats matter, and then pass those project IDs into `get_stats`. The agent handles that logic automatically.
Summarize activity using `get_summaries`
Calling `get_summaries` returns a detailed narrative of the user's coding period. Instead of just raw numbers, you get context about what happened—which is useful for reports. The agent can use this summary text to answer complex questions. For example, it might combine the summary with project details from `list_projects` to explain *why* productivity dropped on a certain date.
Manage tracked projects via `list_projects`
`list_projects` quickly provides a roster of all coding efforts tracked in Wakapi. This tool is the starting point for most reporting actions, giving you context about scope. The agent can check this list first to ensure that any stats or summaries it pulls back are relevant to currently active projects. It acts as a filter before deeper analysis.
Set up Wakapi (WakaTime Alternative) MCP in LangChain
Prerequisites
- Python 3.10+ installed
-
langchain-mcp-adapters+langgraphpackages - Active Vinkius subscription with a valid endpoint token
- 1
Install dependencies
Run
pip install langchain-mcp-adapters langgraph langchain-openai. The MCP adapters package converts MCP tools into native LangChainBaseToolobjects. - 2
Connect via HTTP transport
Use
MultiServerMCPClientwith"transport": "http"pointing to your Vinkius endpoint. Replace[YOUR_TOKEN_HERE]with your token from cloud.vinkius.com. - 3
Create a ReAct agent
Pass the discovered tools to
create_react_agent()from LangGraph. The agent automatically routes Wakapi (WakaTime Alternative) tool calls through the MCP protocol. - 4
Run with any LLM
Swap
ChatOpenAIforChatAnthropic,ChatGoogleGenerativeAI, or any LangChain-compatible model. The MCP tools work identically across all providers.
from langchain_mcp_adapters.client import MultiServerMCPClient
from langgraph.prebuilt import create_react_agent
from langchain_openai import ChatOpenAI
async with MultiServerMCPClient({
"wakapi-wakatime-alternative-mcp": {
"transport": "http",
"url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
}
}) as client:
tools = client.get_tools()
agent = create_react_agent(
ChatOpenAI(model="gpt-4o"),
tools,
)
result = await agent.ainvoke({
"messages": "List recent Wakapi (WakaTime Alternative) transactions"
})
print(result["messages"][-1].content) 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.
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 LangChain
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
Start using the Wakapi (WakaTime Alternative) MCP today
We host it, we monitor it, we maintain it. You just paste one token.