Gavel MCP by usefulapi

io.usefulapiPublished by usefulapi.ioOfficial publisherv1.2.3Updated Nov 5, 2026

List workflows and variables; create sessions and list session documents in Gavel.

The publisher's own server: Ably MCP by usefulapi

VerifiedStreamable HTTPWeb executableProductivity & Workflow Files & Storage

Server details

Identifier: io.usefulapi/gavel
Transport: Streamable HTTP
Runtime: Web executable
Trust: Verified
Published: Nov 3, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified that this server's namespace belongs to usefulapi.io, which also runs its endpoint. That identifies the publisher; it does not make the server's tools safe.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.usefulapi%2Fgavel.svg)](https://sourceweft.com/mcp/io.usefulapi%2Fgavel?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Hosted MCP server for Gavel that lets an assistant list document workflows and their variables, start workflow sessions, and list a session's generated…

What you can do: List the Gavel workflows on the account and read each workflow's variable schema (names, types, labels, options, required flags)
Create a new workflow session with pre-filled variables, returning a session ID and a continuation link for any missing answers
List the documents produced by a completed session, with name, format, template and download link
Check monthly tool-call usage, request a missing feature, and upgrade or cancel the Pro subscription
When to use it: Useful when you generate documents from templated Gavel workflows and want an assistant to look up which workflows and variables exist, start a session with the client details already filled in, and find the resulting files without opening Gavel.
Requirements: Remote streamable HTTP endpoint; no local install. Sign-in is via OAuth, and on first connect you supply your Gavel subdomain and a Gavel API key (Gavel Settings, API Keys). You need a Builder or Admin role and a plan with API access. The free tier allows 50 tool calls per month.

Before you install

You hand over a Gavel API key, which the server stores per user. Creating a session writes data and each call adds another session, so confirm before running it. Document download links require the X-Api-Key header. Upgrade tools return Stripe payment links and can start a paid subscription; cancellation runs to the end of the paid period with no refund for the current period.

Installation

In SourceWeft

Open Gavel MCP by usefulapi in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.usefulapi%2Fgavel/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "gavel-by-usefulapi": {
      "type": "http",
      "url": "https://gavel.usefulapi.io/mcp"
    }
  }
}

README

Gavel MCP by usefulapi

Use your Gavel account from Claude, Cursor, or any MCP client. List workflows and their variables, create workflow sessions and list the documents of a session. Hosted, no local install: connect with your own credentials.

Live endpoint: https://gavel.usefulapi.io/mcp · Homepage: https://usefulapi.io

Connect

Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://gavel.usefulapi.io/mcp.
Claude Code: claude mcp add --transport http gavel https://gavel.usefulapi.io/mcp, then run /mcp to log in.
VS Code: Add to VS Code.
Cursor and other clients: add the URL as a remote MCP server:

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Gavel credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/gavel/

On first connect you provide your Gavel subdomain and a Gavel API key (Gavel → Settings → API Keys). You need a Builder or Admin role and a plan with API access. The server validates it and stores it per user. No keys go in config files.

Tools

Tool	Type	What it does
`gavel_list_workflows`	read	List workflows
`gavel_get_workflow_variables`	read	Get workflow variables
`gavel_create_session`	write	Create a workflow session
`gavel_list_session_documents`	read	List session documents
`gavel_usage_status`	meta	Usage status (free-tier meter)
`gavel_request_feature`	meta	Request a missing feature
`gavel_upgrade`	meta	Upgrade to Pro or Pro+
`gavel_cancel_subscription`	meta	Cancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with gavel_upgrade (it returns a Stripe Checkout link). Cancel any time with gavel_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running gavel_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT — see LICENSE. Documentation only; the server is hosted.

Source: servers/gavel/README.md at commit 4046075

Tools

gavel_list_workflows

List workflows

List the names of all Gavel workflows on the account. API: GET /api/playground?folder=questions.

Takes no parameters.

gavel_get_workflow_variables

Get workflow variables

Get the variable schema of one workflow: each variable name, data type, input type, label, options and whether it is required. Use it to learn what data gavel_create_session accepts. API: GET /officeaddin?pgtypes=<name>.yml.

Parametersworkflow_namerequired

gavel_create_session

Create a workflow session

WRITE: create a new session of a workflow with pre-filled variables. It does not send or sign anything. Each call creates one more session. Returns session_id and a continuation_url. If all variables are given, the URL opens the document download page; else the user answers only the missing questions. Dates: '2024-05-30T'. Date time: ISO 8601. Multi select: array of option labels. Repeating items: array of objects. Use gavel_get_workflow_variables for the names. API: POST /api/documate/v1/interviews/{name}/new.

Parametersvariablesrequiredworkflow_namerequired

gavel_list_session_documents

List session documents

List the documents of a completed workflow session: name, format (docx or pdf), type, source template and download URL. This tool returns metadata only. The download URL needs the X-Api-Key header. API: GET /api/documate/v1/data-manager/workflows/{name}/session/{id}/documents.

Parameterssession_idrequiredworkflow_namerequired

Version history

v1.2.3LatestNov 5, 2026
v1.2.2Nov 5, 2026
v1.2.1Nov 4, 2026
v1.2.0Nov 3, 2026
v1.1.1Nov 3, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 daysRequired25 pts
Auth declaredRequired10 pts
Tools listedRequired15 pts
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts

Business & Commerce15 toolsNov 5, 2026

Plan	Price	Limit
Free	$0	50 tool calls / month
Pro (per user)	$9/mo or $90/yr (2 months free)	Unlimited*