How to Use the GitScrum Time Tracking MCP in Pydantic AI

Q: How do I connect GitScrum Time Tracking to a Pydantic AI agent?

Instantiate MCPToolset with the Vinkius MCP server URL, then pass it into the toolsets argument of your Agent. The framework handles the connection and validates all tool schemas automatically.

Q: How does the framework handle timer conflicts?

Since GitScrum only permits one active timer, calling starttimer while another is running will return an API error. Use getactivetimer first to check the status safely.

Validate every GitScrum budget and time log at runtime using Pydantic AI type-safe MCP tools.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect GitScrum Time Tracking MCP to Pydantic AI

Create your Vinkius account to connect GitScrum Time Tracking to Pydantic AI 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 GitScrum Time Tracking with Pydantic AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Validate time logs at runtime with Pydantic AI

`log_manual_time` records hours worked with strict schema validation. Pydantic AI guarantees that every time entry matches your expected types before sending it to the API, preventing broken payloads. If your agent tries to submit a malformed date or duration, the framework catches the error instantly. This prevents corrupted data from hitting your GitScrum project boards.

Type-safe budget metrics via this MCP Server

`budget_consumption` returns precise financial data that matches your defined Python models. This MCP Server ensures that numeric fields, like currency or hours, never arrive as unparsed strings. Your agent parses `budget_overview` to verify project health. Because the data is strongly typed, your code can safely trigger automated alerts without risking runtime type crashes.

Get clean, structured team performance data

`contributors` pulls activity summaries filtered by specific periods like weeks or quarters. The framework validates the output structure, making it easy to build reliable local dashboards. You can query `team_status` to see who is working on what right now. This raw data flows directly into your internal tracking scripts without requiring manual parsing.

Setup guide

Set up GitScrum Time Tracking MCP in Pydantic AI

Prerequisites

Python 3.10+ installed
pydantic-ai-slim[fastmcp] package
Active Vinkius subscription with a valid endpoint token

1

Install Pydantic AI with FastMCP
Run pip install "pydantic-ai-slim[fastmcp]". The FastMCP toolset replaces the deprecated MCPServerHTTP class with full protocol support.
2

Configure the FastMCPToolset
Pass a JSON-style config dict to FastMCPToolset with your Vinkius URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. Supports Streamable HTTP, SSE, and Stdio transports.
3

Create and run your agent
Pass the toolset to Agent(toolsets=[toolset]) and call agent.run(). Swap openai:gpt-4o for any supported model — Anthropic, Google, Mistral, or Groq.

agent.py

from pydantic_ai import Agent
from pydantic_ai.toolsets.fastmcp import FastMCPToolset

toolset = FastMCPToolset({
    "mcpServers": {
        "gitscrum-time-tracking-mcp": {
            "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
        }
    }
})

agent = Agent(
    "openai:gpt-4o",
    toolsets=[toolset],
    system_prompt="You have access to GitScrum Time Tracking tools.",
)

result = await agent.run("List recent GitScrum Time Tracking transactions")
print(result.output)

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 GitScrum. 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 GitScrum Time Tracking 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 GitScrum Time Tracking MCP in Pydantic AI

Instantiate `MCPToolset` with the Vinkius MCP server URL, then pass it into the `toolsets` argument of your `Agent`. The framework handles the connection and validates all tool schemas automatically.

The framework raises a validation error immediately. This loud failure prevents your agent from making decisions based on corrupted or hallucinated task data.

Yes. Pydantic AI is model-agnostic, meaning you can run this time-tracking server with local models or commercial APIs while maintaining full type safety.

Since GitScrum only permits one active timer, calling `start_timer` while another is running will return an API error. Use `get_active_timer` first to check the status safely.

Your API keys reside safely in Vinkius's zero-trust environment, which issues a single endpoint token for your agent. No raw credentials or private task IDs are stored or logged outside your local execution environment.

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