Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to the Rize MCP server

Vendor MCP
Open markdown

The Rize MCP connector routes your AI agent's tool calls to Rize's own MCP server through Scalekit. Each user signs in to Rize once, and Scalekit stores and refreshes their tokens, so your agent never handles credentials. It comes with 78 tools.

Tools
78
What they doRead · write · destructive
42 · 20 · 1642 read20 write16 destructive
Users sign in with
OAuth app
Scalekit's or your own

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>
  3. Create the Rize MCP connection

    In AgentKit > Connections, create a Rize MCP connection. The name you give it is the connection_name your code passes. See Configure connections.

    Scalekit credentials are available for Rize MCP server, so you don't need to register an OAuth app.

  4. Authorize a user and make your first call

    quickstart.mts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    import { createInterface } from 'node:readline/promises'
    const scalekit = new ScalekitClient(
    process.env.SCALEKIT_ENVIRONMENT_URL,
    process.env.SCALEKIT_CLIENT_ID,
    process.env.SCALEKIT_CLIENT_SECRET,
    )
    const actions = scalekit.actions
    const connector = 'rizemcp'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Rize MCP:', link)
    const rl = createInterface({ input: process.stdin, output: process.stdout })
    await rl.question('Press Enter after authorizing...')
    rl.close()
    // Make your first call
    const result = await actions.executeTool({
    connector,
    identifier,
    toolName: 'rizemcp_get_current_user',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user signs in once. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • rizemcp_get_ai_effectiveness_statsGet AI effectiveness metrics for time entry creation and tagging.Read-only

    Get AI Effectiveness Stats

    Get AI effectiveness metrics for time entry creation and tagging. Shows acceptance rates and improvement trends.

    Inputs

    end_timestringrequired
    End of date range (ISO 8601 datetime, e.g. 2025-06-01T00:00:00Z)
    start_timestringrequired
    Start of date range (ISO 8601 datetime, e.g. 2025-01-01T00:00:00Z)
    creator_emailsarray
    Filter by creator emails (resolved to identity IDs)
    creator_idsarray
    Filter by specific identity IDs
    exclude_identity_idsarray
    Identity IDs to exclude from results (e.g. admin accounts)
    include_member_breakdownboolean
    Include per-member stats breakdowndefault false
    include_weekly_trendboolean
    Include week-over-week trend datadefault false
    team_idstring
    Team ID to filter by. Defaults to the user's default workspace.
    week_countnumber
    Number of weeks for trend data (max 52)default 12
  • rizemcp_get_contractGet a single contract with all its periods and profitability details.Read-only

    Get contract

    Get a single contract with all its periods and profitability details.

    Inputs

    idstringrequired
    Contract ID
    org_idstringrequired
    Organization (billing) ID
  • rizemcp_get_contract_profitabilityGet profitability metrics for a specific contract in a date range.Read-only

    Get contract profitability

    Get profitability metrics for a specific contract in a date range. Returns revenue, costs, margin, hours, budget burn, and period dates. Use list_contracts to find contract IDs. All monetary values are in cents.

    Inputs

    end_datestringrequired
    End date (ISO 8601, e.g. 2025-01-31)
    idstringrequired
    Contract ID
    org_idstringrequired
    Organization (billing) ID
    start_datestringrequired
    Start date (ISO 8601, e.g. 2025-01-01)
  • rizemcp_get_current_userGet the authenticated user's profile including name, email, timezone, and organization info (id, name, logo, role).Read-only

    Get current user

    Get the authenticated user's profile including name, email, timezone, and organization info (id, name, logo, role). Call this first to get your org_id for profitability and contract tools.

    Inputs

    This tool takes no inputs.

  • rizemcp_get_dashboardRead a dashboard's live data with the viewer's permissions: saved Tracked Time totals and groups, Timesheets member/day stats, Personal Productivity metrics, or configured widget data.Read-only

    Get Dashboard

    Read a dashboard's live data with the viewer's permissions: saved Tracked Time totals and groups, Timesheets member/day stats, Personal Productivity metrics, or configured widget data. Use these numbers instead of reconstructing the dashboard with time-entry queries. Dates default to the saved range or this week. Data is returned as Markdown and JSON; respect truncation markers and use provided totals.

    Inputs

    idstringrequired
    Dashboard ID from list_dashboards
    end_datestring
    Inclusive end date (YYYY-MM-DD) to override the saved range
    end_timestring
    Exact exclusive end timestamp (ISO8601), paired with start_time
    start_datestring
    Inclusive start date (YYYY-MM-DD) to override the saved range
    start_timestring
    Exact start timestamp (ISO8601), paired with end_time; do not combine with date overrides
  • rizemcp_get_helpGet documentation on how to use Rize MCP tools.Read-only

    Get help

    Get documentation on how to use Rize MCP tools. Pass a topic to get specific help, or omit for an overview. Topics: time_tracking, profitability, team_management, clients_projects.

    Inputs

    topicstring
    Help topic (default: overview)one of overviewtime_trackingprofitabilityteam_managementclients_projectskeywordsskillsreports_routinesdefault overview
  • rizemcp_get_login_urlReturns the Rize login URL so the user can authenticate in their browser.Read-only

    Get Login URL

    Returns the Rize login URL so the user can authenticate in their browser.

    Inputs

    This tool takes no inputs.

  • rizemcp_get_member_agent_settingsGet another workspace member's agent settings: their personal guidance, tagging instructions, and activity summary instructions.Read-only

    Get member agent settings

    Get another workspace member's agent settings: their personal guidance, tagging instructions, and activity summary instructions. Admins only (org admins, plus admins of an active team the member belongs to) — returns not-found otherwise. Find identity ids via list_workspace_members. For your OWN settings use get_tagging_settings.

    Inputs

    identity_idstringrequired
    The member's identity id (from list_workspace_members)
    org_idstring
    The workspace the member belongs to. Defaults to the caller's active workspace.