# Formatix AI — MCP Server [Health: Active]

**Category:** 💬 Communication  
**Repository:** https://github.com/FormatixAI/mcp-server  
**GitHub Stars:** 0  
**npm Downloads (last month):** 226  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/mcp-server-66

## Description
Branded talent docs: assessment reports, profiles, shortlists & proposals in DOCX/PPTX/PDF/Excel

## Tools
Capabilities this server exposes over MCP:

- **list_document_types** — List the branded talent documents Formatix can generate — assessment reports (Hogan, psychometric, CEO & leadership), progression reports, candidate profiles, shortlists, client submittals, proposals and RPO reports — each with its available output formats (DOCX, PPTX, PDF, XLSX). Call this first to choose a template_id for `generate_document`.
- **generate_document** — Generate a branded, personalized talent document from candidate text. Works for any document type returned by `list_document_types` — assessment reports, executive profiles, shortlists, proposals, etc. Returns a record_id; poll `check_status` until the document is ready to download.
- **format_from_linkedin** — Turn a LinkedIn profile into a polished, branded resume or candidate profile. Paste the visible profile text as `profile_text`. (To capture LinkedIn profiles automatically inside the browser, install the Formatix Chrome extension.) Returns a record_id; poll `check_status`.
- **check_status** — Check whether a generated document is ready and get its download link. Status is 'Processing' (keep polling), 'Formatted' (ready — share the download_url with the client), or 'Failed - <reason>'.
- **claim_access** — Get FREE Formatix access using your COMPANY email. Personal inboxes (gmail, outlook, yahoo, proton, etc.) are not eligible. Returns a free API key — treat it as a secret: store it as FORMATIX_API_KEY in your MCP config rather than leaving it in chat history.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "formatix-ai-mcp-server": {
    "command": "npx",
    "args": ["-y","@formatix-ai/mcp"],
    "env": {
      "FORMATIX_API_KEY": ""
    }
  }
}
```

**Requires environment variables:** `FORMATIX_API_KEY` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What Formatix AI — MCP Server MCP server does

Formatix AI — MCP Server MCP server provides MCP tools for creating branded talent documents from candidate text, structured content or visible LinkedIn profile text. Supported document families include Hogan and other assessment reports, progression reports, executive profiles, candidate shortlists, client submittals, proposals and RPO reports. Depending on the selected template, output can be DOCX, PPTX, PDF or XLSX.

The service is aimed at executive search, in-house recruiting, talent mapping, RPO and HR teams that need repeatable client-facing documents. It can preserve the branding defined in a Formatix template, including fonts, colours, logos and layout.

## How it works

Start with `list_document_types` to retrieve available templates and their output formats. Select a `template_id` and the associated template type, then send source text to `generate_document`. The tool returns a `record_id` rather than an immediately downloadable file.

Use `check_status` with that record ID until the result is either `Formatted`, `Processing` or `Failed - <reason>`. A formatted result includes a `download_url` that an agent can return to the user. Generated files are processed by Formatix’s platform; the local package acts as a thin MCP client rather than performing document rendering itself.

For LinkedIn content, `format_from_linkedin` accepts the visible profile text and creates a branded resume or candidate profile. Automatic profile capture requires the separate Formatix Chrome extension, according to the project documentation.

## Setup and configuration

The repository publishes the `@formatix-ai/mcp` npm package. A local MCP client can run it with:

```json
{
  "command": "npx",
  "args": ["-y", "@formatix-ai/mcp"],
  "env": {
    "FORMATIX_API_KEY": "fxi_your_key_here"
  }
}
```

A Formatix API key is supplied through `FORMATIX_API_KEY`. The `claim_access` tool can issue free access when the user provides an eligible company email; personal email providers are not eligible. `FORMATIX_API_BASE` can override the default platform URL for testing another environment.

The documentation also describes a hosted MCP endpoint at `https://platform.formatix.ai/mcp`, which can be connected through clients supporting remote MCP connectors. Remote authentication can use a Formatix account through OAuth or an `fxi_` API key.

## Tools and capabilities

- `list_document_types`: Enumerate document templates and available formats.
- `generate_document`: Create a personalized branded document from source text.
- `format_from_linkedin`: Convert supplied LinkedIn profile text into a resume or candidate profile.
- `check_status`: Poll document generation and retrieve a download link when ready.
- `claim_access`: Request a free API key with a company email.

## Limitations and notes

Formatix AI — MCP Server MCP server does not perform formatting locally; extraction, rendering and generation take place on the Formatix platform. An API key is needed for normal operations, while the access-claim flow is the documented exception. LinkedIn automation is not provided by the MCP tools themselves and depends on the separate Chrome extension. Generated documents are asynchronous, so callers must retain the record ID and poll before presenting a download link.

_Full upstream README: https://allmcps.com/mcp/mcp-server-66/readme_