{
  "markdown": "# Formatix AI — MCP Server\n\n**The only AI that automates and personalizes _any_ branded talent document — not just CVs.**\n\nTurn a CV, a LinkedIn profile, or structured data into **assessment reports (Hogan, psychometric, CEO & leadership), progression reports, executive profiles, candidate shortlists, client submittals, proposals and RPO reports** — exported as **DOCX, PPTX, PDF or Excel**, perfectly on-brand.\n\nConnect Formatix to **Claude, ChatGPT, Perplexity, Cursor, Claude Code** — or any MCP-compatible AI agent — and let the AI generate the finished, client-ready document for you.\n\n[![npm](https://img.shields.io/npm/v/@formatix-ai/mcp.svg)](https://www.npmjs.com/package/@formatix-ai/mcp)\n[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](./LICENSE)\n[![Trustpilot](https://img.shields.io/badge/Trustpilot-Reviews-00b67a.svg)](https://www.trustpilot.com/review/formatix.ai)\n[![GitHub](https://img.shields.io/badge/GitHub-FormatixAI%2Fmcp--server-181717.svg)](https://github.com/FormatixAI/mcp-server)\n\n> Website: **https://formatix.ai** · Reviews: **[Trustpilot](https://www.trustpilot.com/review/formatix.ai)**\n\n---\n\n## Why Formatix is different\n\nEvery other \"CV formatter\" stops at _one CV → one Word document_. Formatix is the only platform that **templatizes and automates the documents nobody else does**, across every format and use case:\n\n| Document type | Examples | Formats |\n| --- | --- | --- |\n| **Assessment reports** | Hogan reports, psychometric reports, CEO assessment, leadership assessment | DOCX · PPTX · PDF |\n| **Progression reports** | Succession & talent-review packs, 9-box, promotion cases | DOCX · PPTX · XLSX |\n| **Executive profiles** | One-page bios, branded candidate profiles, blind/anonymized CVs | DOCX · PPTX · PDF |\n| **Shortlists & decks** | Multi-candidate shortlist decks, longlists, slate presentations | PPTX |\n| **Client deliverables** | Client submittals, proposals, RPO reports, market & comp intelligence | DOCX · PPTX · PDF · XLSX |\n\nEvery document is generated from your own branded template — fonts, colours, logos and layout preserved exactly.\n\n## Who uses it\n\n- **Executive search firms** — client-branded profiles, shortlist decks and proposals in minutes.\n- **In-house exec & leadership recruiting (TA)** — board-ready candidate slates and assessment summaries.\n- **Talent mapping / RPO teams** — market maps, comp benchmarking, RPO reporting.\n- **HR / People teams** — succession planning, talent reviews and promotion packs.\n\n## Three ways to use Formatix\n\n1. **Remote MCP** — point ChatGPT, Claude or Perplexity at the hosted Formatix MCP endpoint.\n2. **`npx` (this package)** — run locally inside Claude Desktop, Cursor or Claude Code.\n3. **Chrome extension** — capture any LinkedIn profile and turn it into a polished resume in one click. → https://formatix.ai\n\n---\n\n## Quick start\n\n### Get a free API key (company email)\n\nFree access requires a **company email** — personal inboxes (gmail, outlook, yahoo, proton…) are not eligible.\n\n- In any connected AI client, just ask it to **\"claim free Formatix access with my email <you@yourcompany.com>\"** — the `claim_access` tool issues a key instantly, **or**\n- Sign up at **https://formatix.ai** and create a key in **Settings → API keys**.\n\nSet the key as `FORMATIX_API_KEY` in the configs below.\n\n### Claude Desktop / Claude Code\n\n`claude_desktop_config.json` (or `.mcp.json` for Claude Code):\n\n```json\n{\n  \"mcpServers\": {\n    \"formatix\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@formatix-ai/mcp\"],\n      \"env\": {\n        \"FORMATIX_API_KEY\": \"fxi_your_key_here\"\n      }\n    }\n  }\n}\n```\n\n### Cursor\n\n`~/.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"formatix\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@formatix-ai/mcp\"],\n      \"env\": { \"FORMATIX_API_KEY\": \"fxi_your_key_here\" }\n    }\n  }\n}\n```\n\n### ChatGPT / Perplexity (remote connector)\n\nAdd a custom connector / MCP server pointing at the hosted endpoint:\n\n```\nhttps://platform.formatix.ai/mcp\n```\n\nAuthenticate with your Formatix account (OAuth) or paste your `fxi_` API key when prompted.\n\n---\n\n## Tools\n\n| Tool | What it does |\n| --- | --- |\n| `list_document_types` | List every document Formatix can generate (assessment reports, profiles, shortlists, proposals…) with available formats. Call this first. |\n| `generate_document` | The hero. Any source text → any branded document in DOCX/PPTX/PDF/XLSX. Returns a `record_id`. |\n| `format_from_linkedin` | LinkedIn profile text → polished resume / candidate profile. |\n| `check_status` | Poll a `record_id`; returns the download link when the document is ready. |\n| `claim_access` | Get a free API key with your company email. |\n\n### Typical agent flow\n\n```\nlist_document_types()                         → choose a template_id + template_type\ngenerate_document(source_text, template_id,   → returns record_id\n                  template_type, output_format)\ncheck_status(record_id)                        → \"Formatted\" + download_url\n→ hand the download_url back to the client\n```\n\n---\n\n## Configuration\n\n| Env var | Default | Purpose |\n| --- | --- | --- |\n| `FORMATIX_API_KEY` | _(none)_ | Your `fxi_` key. Without it, only `claim_access` works. |\n| `FORMATIX_API_BASE` | `https://platform.formatix.ai` | Override for testing against another environment. |\n\n## How it works\n\nThis package is a **thin client**. All formatting, AI extraction and rendering run on the Formatix platform; this server simply exposes a small, agent-friendly set of tools over the [Model Context Protocol](https://modelcontextprotocol.io). **No credentials are stored in this repo** — you supply your own key.\n\n## Links\n\n- **Website & sign-up:** https://formatix.ai\n- **Trustpilot reviews:** https://www.trustpilot.com/review/formatix.ai\n- **Issues:** https://github.com/FormatixAI/mcp-server/issues\n\n## License\n\nMIT © Formatix AI Ltd\n",
  "bytes": 5873,
  "sha": "390d1d6150031261d1a979f6f2ac301a42564956229118941be86b29a7447f03",
  "repo_slug": "formatixai/mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_formatixai_mcp_server_e89f3153/readme"
}