# Use Emboss in Antigravity

Emboss runs an MCP server at `https://api.getemboss.ai/mcp`. Connect it once
and fill PDF forms from a conversation: make a flat PDF fillable, fill it
from notes or documents you paste or attach, or fill it for every row of a
spreadsheet. Sign in with an Emboss account when prompted. Emboss is not yet
listed in Antigravity's plugin directory, at the time of writing.

## Connect

Antigravity's CLI and IDE both read MCP server configuration from
`mcp_config.json`, where remote servers use `serverUrl` rather than `url` or
`httpUrl`:

```json
{
  "mcpServers": {
    "emboss": {
      "serverUrl": "https://api.getemboss.ai/mcp"
    }
  }
}
```

You can also install the connector as an Antigravity plugin:

```
git clone https://github.com/GetEmboss-ai/emboss-gemini-extension
agy plugin install ./emboss-gemini-extension
```

## Availability

At the time of writing, the Antigravity CLI does not send OAuth tokens to
HTTP MCP servers (see [antigravity-cli issue
#25](https://github.com/google-antigravity/antigravity-cli/issues/25)). Until
that issue is fixed, add an Emboss API key (see
[Authentication](/docs/authentication)) as a header in `mcp_config.json`
instead of relying on sign-in:

```json
{
  "mcpServers": {
    "emboss": {
      "serverUrl": "https://api.getemboss.ai/mcp",
      "headers": {
        "Authorization": "Bearer sk_..."
      }
    }
  }
}
```

## What you can do

- **Make a flat PDF fillable.** Attach a PDF and ask Antigravity to detect
  its fields; see the [MCP tools reference](/docs/mcp-tools) for
  `create_form`.
- **Fill a form from context.** Attach a form and one or more context
  documents; see [`fill_form_from_context`](/docs/mcp-tools) for how the
  match works.
- **Fill a form for every row in a spreadsheet.** Attach a form and a
  spreadsheet; see [`fill_batch`](/docs/mcp-tools) for the mapping and row
  output.

## Billing and privacy

Free tier: The first 5 form creations, 5 context fills, 5 standard fills, 5 verifications, 5 reads, and 5 packages each month are free when the job is 5 pages or fewer (a context fill counts the form and its documents together); a longer job is charged and does not use a free one. See
[Pricing](/pricing) for current rates. Only the arguments a tool call needs
are sent to Emboss. Disconnect at any time from **Dashboard**, then
**Account**, then **Connected apps**. A connection made with an API key is
not listed there: revoke or turn off the key on the **API Keys** page instead.

## See also

- [Fill PDFs from your own data](https://getemboss.ai/use-cases/fill-pdfs-from-your-data)
- [MCP server](https://getemboss.ai/glossary/mcp-server)
- [Use Emboss from agent frameworks (A2A)](https://getemboss.ai/docs/a2a)
- [Use Emboss in Gemini](https://getemboss.ai/docs/gemini)
- [Use Emboss in Claude](https://getemboss.ai/docs/claude)