# Use Emboss in Gemini

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 Gemini's app directory, at the time of writing.

For a company's Gemini Enterprise, see [Use Emboss in Gemini Enterprise](/docs/gemini-enterprise).

## Connect

1. Open **Connected Apps** in Gemini settings.
2. Add a custom app.
3. Paste the server URL: `https://api.getemboss.ai/mcp`.
4. Sign in to Emboss when prompted.

## Availability

Available in Gemini Spark on Google AI Ultra and Pro, for personal Google
accounts in the US, at the time of writing.

## What you can do

- **Make a flat PDF fillable.** Attach a PDF and ask Gemini 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.

## For developers (Gemini API)

The Gemini Interactions API's `mcp_server` tool takes a server URL plus
static headers instead of an OAuth flow. Use an Emboss API key (see
[Authentication](/docs/authentication)) as the bearer token:

```json
{
  "tools": [
    {
      "mcp_server": {
        "url": "https://api.getemboss.ai/mcp",
        "headers": {
          "Authorization": "Bearer sk_..."
        }
      }
    }
  ]
}
```

## 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

- [Pre-fill forms from context documents](https://getemboss.ai/use-cases/prefill-from-context)
- [Model Context Protocol (MCP)](https://getemboss.ai/glossary/model-context-protocol)
- [Use Emboss in Gemini Enterprise](https://getemboss.ai/docs/gemini-enterprise)
- [Use Emboss in Grok](https://getemboss.ai/docs/grok)
- [MCP tools reference](https://getemboss.ai/docs/mcp-tools)