Skip to main content
Firma lets you add legally binding e-signatures to anything you build with Google Antigravity. Connect Firma’s MCP servers to Antigravity CLI or Antigravity Desktop and the agent can generate accurate Firma integration code, manage your signing requests, and operate on your Firma data directly from the terminal or the IDE. This guide covers two ways to use Firma with Antigravity:
  1. Antigravity CLI - Terminal-based agent with MCP support. Best for developers who work in the terminal.
  2. Antigravity Desktop - Standalone IDE with the same MCP configuration. Best for developers who prefer a visual editor.

Prerequisites

  • A Firma account with an API key
  • Antigravity CLI or Antigravity Desktop installed
  • At least one Firma template with signing fields configured
Firma uses the raw API key as the Authorization header value - do not prefix it with Bearer. This differs from many other APIs.

Getting started

Antigravity CLI (agy) is a terminal-based AI agent that supports MCP servers for external tool integration. Connecting Firma’s MCP servers lets the agent build Firma integrations and operate on your Firma data.

Step 1: Install Antigravity CLI

If you haven’t already, install the CLI:
On Windows (PowerShell):
The binary installs as agy. You may need to add ~/.local/bin to your PATH.

Step 2: Add the Firma MCP servers

Create or edit ~/.gemini/antigravity/mcp_config.json and add both Firma servers:
  • firma-api gives Antigravity direct access to the Firma API - 84 tools across signing requests, templates, workspaces, and webhooks.
  • firma-docs gives Antigravity access to Firma’s full documentation so it generates accurate integration code.
Restart the CLI after saving the config. On first use of a Firma tool, Antigravity will walk you through signing in with your Firma account via OAuth.
When to use which server: firma-api is for doing things (sending signing requests, managing templates). firma-docs is for building things (generating integration code with accurate API details). Most developers want both connected.

Step 3: Use Firma from the CLI

Once connected, you can ask Antigravity to build Firma integrations or operate on your data:Generate a backend integration:
List your signing requests:
Send a signing request:
Add embedded signing to a React app:
Wire up webhooks:
Referencing “the Firma docs” explicitly tells the agent to query the firma-docs MCP server before writing code. Without that, it may fall back to general knowledge and miss endpoint or auth details.

What the agent generates

When you ask Antigravity to build a Firma integration, the generated backend code should look like this:
The create-and-send endpoint creates the signing request and sends it to recipients atomically. If you need to review or modify the request before sending, use POST /signing-requests to create a draft, then POST /signing-requests/{id}/send separately.
Never expose your API key in frontend code. Always call the Firma API from a backend where secrets are kept secure.

Webhook integration

To track signing events in real time, ask Antigravity to add a webhook handler:
The agent will generate something like this:
In the Firma dashboard under Settings > Webhooks, register your endpoint URL. Firma sends events for all major state changes. See the webhooks guide for the full event list and signature verification.
Always verify the webhook signature using your Firma webhook signing secret in production. See the webhooks guide for implementation details.

Embedded signing

For apps where signers complete documents inside your UI instead of opening a Firma-hosted page, the create-and-send response includes first_signer.id (the signing_request_user_id) and a ready-made first_signer.signing_link. Load the signer URL in an iframe:
See the embedded signing guide for full setup including security best practices.

Migrating from Gemini CLI

If you previously used Firma with Gemini CLI, here is what changed: Import your existing Gemini CLI plugins:
Gemini CLI stops serving for individual-tier users on June 18, 2026. If you are on a Gemini Code Assist Standard/Enterprise license, the Gemini CLI IDE extensions continue to work.

Tips

  • Use firma-docs when building, firma-api when operating. The docs server helps the agent write correct integration code. The API server lets the agent manage signing requests, templates, and workspaces directly.
  • Pass template_id explicitly. Templates are the safest way to constrain what the agent can send. Let the agent pick a template ID from a short, named list you control.
  • Validate before sending. For higher-stakes documents, ask the agent to create a draft with POST /signing-requests, then confirm before calling POST /signing-requests/{id}/send.
  • Workspaces for multi-tenant apps. If you are building a SaaS product, give each end customer their own Firma workspace so templates and usage stay isolated.

Next steps