mcparmory-convertapi 1.0.2

MCP server for ConvertAPI

ConvertAPI MCP Server

Base URL: https://v2.convertapi.com

API Info

• API License: Apache 2.0 — http://www.apache.org/licenses/LICENSE-2.0.html
• Terms of Service: https://www.convertapi.com/terms

---

Install

Quick Start (recommended)

SECRET_BEARER_TOKEN=YOUR_SECRET_BEARER_TOKEN \
TOKEN_BEARER_TOKEN=YOUR_TOKEN_BEARER_TOKEN \
JWT_PRIVATE_KEY=YOUR_JWT_PRIVATE_KEY \
JWT_ISSUER_ID=YOUR_JWT_ISSUER_ID \
uvx mcparmory-convertapi

With pip

pip install mcparmory-convertapi
SECRET_BEARER_TOKEN=YOUR_SECRET_BEARER_TOKEN \
TOKEN_BEARER_TOKEN=YOUR_TOKEN_BEARER_TOKEN \
JWT_PRIVATE_KEY=YOUR_JWT_PRIVATE_KEY \
JWT_ISSUER_ID=YOUR_JWT_ISSUER_ID \
mcparmory-convertapi

MCP Client Configuration

Add to your MCP client config (e.g. Claude Desktop, Cursor, Codex):

{
  "mcpServers": {
    "convertapi": {
      "command": "uvx",
      "args": ["mcparmory-convertapi"],
      "env": {
        "SECRET_BEARER_TOKEN": "YOUR_SECRET_BEARER_TOKEN",
        "TOKEN_BEARER_TOKEN": "YOUR_TOKEN_BEARER_TOKEN",
        "JWT_PRIVATE_KEY": "YOUR_JWT_PRIVATE_KEY",
        "JWT_ISSUER_ID": "YOUR_JWT_ISSUER_ID"
      }
    }
  }
}

---

Credentials

Set the following environment variables (via MCP client env config, shell export, or .env file):

• SECRET_BEARER_TOKEN — Bearer token
• TOKEN_BEARER_TOKEN — Bearer token
• JWT_PRIVATE_KEY — Path to .pem file or inline PEM key
• JWT_ISSUER_ID — Issuer ID (App ID, Team ID, etc.) Do not commit credentials to version control.

JWT Bearer

This server uses JWT Bearer authentication — tokens are generated automatically from a private key.

Set JWT_PRIVATE_KEY to either:

• File path: /path/to/private-key.pem
• Inline PEM: paste the full PEM content with newlines replaced by \n

Set JWT_ISSUER_ID to the application/issuer ID provided by the API (e.g. GitHub App ID).

Optional settings (see .env for details): algorithm (default RS256), expiry (default 600s), audience, key ID, token exchange URL.

---

Run Locally

First, configure your credentials in .env (see Credentials above).

pip install -r requirements.txt
python server.py

Connect MCP Client

Edit .mcp.json and replace <SERVER_DIR> with the absolute path to this directory, then add to your MCP client configuration.

Example (if server is at /home/user/mcp-servers/convertapi):

{
  "mcpServers": {
    "convertapi": {
      "command": "python",
      "args": ["/home/user/mcp-servers/convertapi/server.py"]
    }
  }
}

---

Docker

First, configure your credentials in .env (see Credentials above).

docker build -t convertapi .
docker run -p 8000:8000 --env-file .env convertapi

Before running, make sure ports 8000 are free.For Docker, use SSE transport in your MCP client config:

{
  "mcpServers": {
    "convertapi": {
      "type": "sse",
      "url": "http://localhost:8000/sse"
    }
  }
}

---

Files

• .env - Credentials and server configuration
• .mcp.json - MCP client config template
• Dockerfile - Container build
• LICENSE - MIT license for this generated code
• requirements.txt - Python dependencies
• README.md - This file
• server.py - MCP server entry point
• _auth.py - Authentication handlers
• _models.py - Request/response models
• _validators.py - Input validation

Note: Files starting with . are hidden by default on macOS/Linux. Use ls -a in terminal or enable "Show hidden files" in your file manager to see .env and .mcp.json.

---

_{Generated by MCP Blacksmith · Quickstart docs · Report a bug}