# Use Emboss in Grok

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

## Connect

1. Go to [grok.com/connectors](https://grok.com/connectors).
2. Choose **New Connector**, then **Custom**.
3. Paste the server URL: `https://api.getemboss.ai/mcp`.
4. Sign in to Emboss when prompted.

## Availability

Available to all Grok users; in a Business or Enterprise workspace, an admin
adds it.

## What you can do

- **Make a flat PDF fillable.** Attach a PDF and ask Grok 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 (xAI API)

xAI's Remote MCP Tools takes a server URL plus a static header instead of an
OAuth flow. Use an Emboss API key (see
[Authentication](/docs/authentication)) as the bearer token:

```json
{
  "mcp_servers": [
    {
      "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)
- [MCP server](https://getemboss.ai/glossary/mcp-server)
- [Use Emboss in Gemini](https://getemboss.ai/docs/gemini)
- [Use Emboss in ChatGPT](https://getemboss.ai/docs/chatgpt)
- [MCP tools reference](https://getemboss.ai/docs/mcp-tools)
