npm package: @itfast/mcp-server
Description: MCP server for ITFast — access 196 AI tools from Claude Desktop, Cursor, and Claude Code
Latest version: 1.0.0

# @itfast/mcp-server

MCP (Model Context Protocol) server for [ITFast](https://itfast.eu) — access 196 AI tools directly from Claude Desktop, Cursor, or Claude Code.

## What is this?

ITFast is an AI tools platform with 196 business tools (writing, data analysis, lead generation, document processing, and more). This MCP server wraps the ITFast REST API so any MCP-compatible client can use all tools natively.

## Prerequisites

1. **ITFast account** — Sign up at [itfast.eu](https://itfast.eu)
2. **API keys** — Create at [Dashboard > API Keys](https://itfast.eu/dashboard/api-keys)
3. **Credits** — Each tool execution costs 1+ credit. Get credits via subscription or credit packs.

## Installation

No installation needed — run directly with `npx`:

```bash
npx -y @itfast/mcp-server
```

Or install globally:

```bash
npm install -g @itfast/mcp-server
```

## Configuration

### Claude Desktop

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "itfast": {
      "command": "npx",
      "args": ["-y", "@itfast/mcp-server"],
      "env": {
        "ITFAST_CLIENT_ID": "itf_your_client_id",
        "ITFAST_CLIENT_SECRET": "sk_live_your_secret"
      }
    }
  }
}
```

**Config file location:**
- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
- Windows: `%APPDATA%\Claude\claude_desktop_config.json`

### Cursor

Add to `.cursor/mcp.json` in your project root:

```json
{
  "mcpServers": {
    "itfast": {
      "command": "npx",
      "args": ["-y", "@itfast/mcp-server"],
      "env": {
        "ITFAST_CLIENT_ID": "itf_your_client_id",
        "ITFAST_CLIENT_SECRET": "sk_live_your_secret"
      }
    }
  }
}
```

### Claude Code

Add to your project or global settings:

```bash
claude mcp add itfast -- npx -y @itfast/mcp-server
```

Then set environment variables:
```bash
export ITFAST_CLIENT_ID=itf_your_client_id
export ITFAST_CLIENT_SECRET=sk_live_your_secret
```

## Environment Variables

| Variable | Required | Description |
|----------|----------|-------------|
| `ITFAST_CLIENT_ID` | Yes | Your API client ID (format: `itf_...`) |
| `ITFAST_CLIENT_SECRET` | Yes | Your API client secret (format: `sk_live_...`) |
| `ITFAST_API_URL` | No | Override API base URL (default: `https://itfast.eu/api/v1`) |

## Available Tools

All 196 ITFast tools are registered as MCP tools with the prefix `itfast_`. Examples:

- `itfast_quote` — Generate professional quotes
- `itfast_email-writer` — Write business emails
- `itfast_pdf` — Analyze PDF documents
- `itfast_seo-audit` — SEO audit from a URL
- `itfast_contract-review` — Review legal contracts

Each tool accepts:
- `input` (required) — The text, URL, or document content to process
- `preferences` (optional) — JSON string with output preferences: `{"tone":"formal","outputLength":"detailed","outputFormat":"bullets","customInstructions":"Keep it under 200 words"}`

## Resources

- `itfast://credits` — Current credit balance (JSON)
- `itfast://tools` — Full tool catalog listing

## Example Usage

Once configured, ask Claude:

> "Use ITFast to generate a professional quote for 3 hours of web development at $85/hour"

> "Analyze this URL with ITFast's SEO audit tool: https://example.com"

> "Check my ITFast credit balance"

## File-Type Tools

Some tools (like PDF Analyzer) accept file input. Over MCP stdio, binary file upload is not supported. Instead, paste the document text directly as the `input` parameter. For binary file processing, use the ITFast web UI or REST API directly.

## Troubleshooting

### "Missing ITFast API credentials"
Set `ITFAST_CLIENT_ID` and `ITFAST_CLIENT_SECRET` in your MCP client configuration.

### "Invalid API credentials"
Double-check your client ID and secret at [itfast.eu/dashboard/api-keys](https://itfast.eu/dashboard/api-keys). Make sure you're using the full values including the `itf_` and `sk_live_` prefixes.

### "Insufficient credits"
Your account is out of credits. Purchase more at [itfast.eu/dashboard/credits](https://itfast.eu/dashboard/credits).

### "Rate limited"
You're sending requests too fast. The API allows 30 executions/minute and 120 reads/minute per API key.

### Tools not appearing
Restart your MCP client after configuration changes. The server fetches the tool list on startup.

## License

MIT