How do I use Progresso MCP?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Progresso MCP list my open tickets" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Progresso MCP

by cetijunior

Overview Schema Source Related Servers Discussions Admin

TypeScript

Progresso MCP

Hand the live Progresso workspace (same Supabase as progresso.rritjesade.com) to any MCP client — Cursor, Claude Desktop, Inspector, etc.

Docs: https://progresso.rritjesade.com/docs/mcp · Admins: Settings → Connectors

One-command (Cursor)

{
  "mcpServers": {
    "progresso": {
      "command": "npx",
      "args": ["-y", "github:cetijunior/progresso-mcp"],
      "env": {
        "SUPABASE_URL": "https://dtigibuhzhmxrkfzvijt.supabase.co",
        "SUPABASE_ANON_KEY": "sb_publishable_…",
        "PROGRESSO_REFRESH_TOKEN": "…"
      }
    }
  }
}

Copy your refresh token from Settings → Connectors (web or Mac). Prefer refresh over access JWT. Never use the service-role key.

When published to npm: npx -y progresso-mcp (same env).

Related MCP server: Supabase MCP Server

Local / Inspector

cp .env.example .env   # URL, anon key, PROGRESSO_REFRESH_TOKEN
npm install
npm run build
npm run inspector

Tools (v0.2)

Tool	Purpose
`dashboard_pulse`	Financials + presence + WIP count
`list_tickets` / `get_ticket` / `create_ticket` / `update_ticket` / `move_ticket` / `add_comment`	Board work
`list_leads` / `create_lead` / `update_lead`	CRM
`list_projects` / `update_project`	Projects
`check_in` / `check_out` / `stop_timer`	Time

Available Tools

15 tools

add_commentC

Add a comment on a ticket (supports @Name mentions in body text).

Inputs: body (required), ticket_id (required).

check_inA

Check in for today. Optionally start a timer on a ticket (omit ticket_id for presence-only if you are admin — still recommended to pass a ticket).

Inputs: ticket_id.

check_outA

Check out for today. Running timers are stopped with an auto note.

Inputs: no named parameters.

create_leadC

Create a CRM lead.

Inputs: name (required), notes, status, company, +2 more.

create_ticketA

Create a ticket (or sub-ticket via parent_id). Prefer zz-scratch boards when testing live.

Inputs: title (required), status, board_id, parent_id, +1 more.

dashboard_pulseC

Agency pulse: financials summary, who's checked in, in-progress ticket count.

Inputs: no named parameters.

get_ticketB

Fetch one ticket plus its sub-tickets.

Inputs: ticket_id (required).

list_leadsB

List CRM leads (newest first).

Inputs: limit, status.

list_projectsC

List projects with status.

Inputs: status.

list_ticketsB

List top-level tickets, optionally filtered by board_id or status.

Inputs: limit, status, board_id.

move_ticketC

Move a ticket to a new column (status) and optional position.

Inputs: status (required), ticket_id (required), position.

stop_timerC

Stop the running timer. Work note is required.

Inputs: note (required).

update_leadC

Patch a lead's status, temperature, or follow-up date (YYYY-MM-DD).

Inputs: lead_id (required), status, temperature, next_follow_up.

update_projectC

Patch a project's name, description, or status.

Inputs: project_id (required), name, status, description.

update_ticketC

Patch ticket fields (title, description, status, due_at, payment).

Inputs: ticket_id (required), title, amount, due_at, +3 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

Deploy Server

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

B3.2/5.0

Scored 2026-08-04 02:25 across 15 tools

Disambiguation4/5

Most tools have clearly distinct purposes: ticket lifecycle (create/update/move/get/list), leads (list/create/update), project management (list/update), and time tracking (check_in/check_out/stop_timer). The main overlap is move_ticket vs update_ticket since moving is essentially updating status, though the descriptions clarify move is column-specific while update is general field patching. dashboard_pulse is distinct enough as an aggregate view.

Naming Consistency4/5

Most tools follow a consistent verb_noun pattern (list_tickets, create_ticket, update_ticket, move_ticket, list_leads, create_lead, update_lead, list_projects, update_project). Minor deviations exist like check_in/check_out/stop_timer and dashboard_pulse which don't follow the resource-noun pattern, but they're still understandable and follow predictable verb-first phrasing.

Tool Count5/5

15 tools for an agency management/progress tracking server is well-scoped. Each tool covers a distinct functional area: tickets, leads, projects, time tracking, and dashboard aggregate. The count feels complete without being bloated, and each tool appears necessary for the stated purpose.

Completeness3/5

Ticket management is thorough (list, get, create, update, move, comment), and leads/projects have basic CRUD. However, there are notable gaps: no way to delete tickets, leads, or projects; no tool to list tickets for a specific ticket's sub-tickets (only get_ticket for one); CRM has no way to view individual lead details separately from the list; and there's no tool to list or view project details beyond the list. The time-tracking tools depend on tickets but their interaction with the ticket surface feels slightly disconnected.

Maintenance

ActivitySlowing

ResponsivenessNo recent community issues

Resources

Related MCP Connectors

Supabase
com.supabase
MCP server for interacting with the Supabase platform
Cloud Platforms Databases Developer Tools
33,004
https://mcp.supabase.com/mcp
mission-control
io.github.dinof777
Read and write Mission Control state via MCP — projects, tasks, subtasks, templates, status updates.
Project Management Workplace & Productivity
2
https://mission-control-six-kohl.vercel.app/api/mcp
Linear by Nova (CIVAI)
co.civai.nova
Issues, projects, cycles, and roadmaps via the official Linear hosted MCP server.
Project Management Product Management
1
https://nova.civai.co/mcp/agents/mcp-linear
TimequipA
com.timequip
Manage Timequip projects, tasks, comments, members, and dashboards through MCP.
Project Management Workplace & Productivity
281
https://mcp.timequip.com/mcp

Related MCP Servers

MCP Supabase Server
Databases Cloud Storage Cloud Platforms
cloud9-labs
A
license
B
quality
D
maintenance
MCP server for Supabase database and storage operations, enabling querying, inserting, updating, deleting rows, schema introspection, and file storage management.
Updated 9 months ago (2026-02-12 04:49 UTC)
12
16 npm
MIT
Supabase MCP Server
Security Databases Cloud Platforms
elsheppo
A
license
Not graded
quality
B
maintenance
Exposes your application's resources and tools as an MCP server using Supabase Auth, Postgres, and Row Level Security, allowing authorized users to connect via compatible MCP clients.
Updated a month ago (2026-10-15 17:39 UTC)
339 npm
3
MIT
TodoAI MCP Server
Project Management Note Taking
gneed49
A
license
Not graded
quality
C
maintenance
Enables CRUD management of tasks, workspaces, and notes via a remote MCP server with Supabase authentication and synchronization across Linux, Android, and ChatGPT.
Updated 3 months ago (2026-08-18 01:25 UTC)
MIT
App MCP
Databases Developer Tools
elvinbaghele
F
license
Not graded
quality
C
maintenance
Enables turning an existing Supabase database and Edge Functions into an MCP server, exposing selected tables with Row Level Security and Edge Functions as tools for use in MCP clients.
Updated 17 days ago (2026-10-26 10:11 UTC)
-

Progresso MCP

One-command (Cursor)

Local / Inspector

Tools (v0.2)

Available Tools

Tool Schema Changelog

TDQS

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

MCP Supabase Server

Supabase MCP Server

TodoAI MCP Server

App MCP