Skip to main content
Glama
README.md
# AIFAIS MCP Server ⚑

De officiΓ«le Model Context Protocol (MCP) server voor AIFAIS. Geef je AI agents (zoals Claude of Cursor) direct toegang tot specialistische tools voor de Nederlandse markt.

> **Noot:** Deze MCP server is specifiek voor Claude Desktop en Cursor. Andere AI agents kunnen de API [direct aanroepen](https://aifais.mobi/developers/docs#direct-api) via HTTP zonder server.

## πŸš€ Quick Start

### Voor Claude Desktop
Voeg dit toe aan je `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "aifais": {
      "command": "npx",
      "args": ["-y", "github:aifais/aifais-mcp-server"]
    }
  }
}
```

### Voor Cursor IDE
1. Ga naar **Settings** -> **Features** -> **MCP**.
2. Klik op **+ Add MCP Server**.
3. Kies type **command**.
4. Gebruik als command: `npx -y github:aifais/aifais-mcp-server`.

---

## πŸ’Ž Beschikbare Tools

### `scan_invoice` (0.001 SOL)
Scant een factuur/bonnetje en extraheert gestructureerde data via AI.

**Parameters:**
- `invoiceBase64 (required)`
- `mimeType (required)`
- `signature (optional, 0.001 SOL)`

### `create_invoice` (Gratis)
Genereer een PDF factuur op basis van JSON data.

**Parameters:**
- `ownName`
- `clientName`
- `items (array)`

### `generate_quote` (Gratis)
Genereer een PDF offerte op basis van JSON data.  
**Parameters:**
- `companyName`
- `clientName`
- `items (array)`
- `validUntil (optional)`

### `check_contract` (0.001 SOL)
Analyseer een juridisch contract op risico's.  
**Parameters:**
- `contractBase64 (required)`
- `signature (required, 0.001 SOL)`

### `generate_terms` (0.001 SOL)
Genereer algemene voorwaarden op maat.  
**Parameters:**
- `companyName`
- `companyType`
- `signature (required, 0.001 SOL)`

### `cv_screener` (0.001 SOL)
Analyseer en score CV's tegen een vacature.
**Parameters:**
- `cvBase64 (required)`
- `mimeType (required)`
- `jobDescription (required)`
- `signature (required, 0.001 SOL)`

### `interview_questions` (0.001 SOL)
Genereer gepersonaliseerde sollicitatievragen.
**Parameters:**
- `jobTitle`
- `jobDescription`
- `experienceLevel`
- `questionCount (optional)`
- `signature (required, 0.001 SOL)`

### `social_planner` (0.001 SOL)
Genereer een social media planning.
**Parameters:**
- `topic`
- `platforms (array)`
- `postCount (optional)`
- `tone (optional)`
- `signature (required, 0.001 SOL)`

### `lead_scorer` (0.001 SOL)
Score en prioriteer sales leads.
**Parameters:**
- `companyName`
- `industry`
- `companySize`
- `budget`
- `engagement (object)`
- `signature (required, 0.001 SOL)`

### `pitch_deck` (0.001 SOL)
Genereer de structuur en content voor een pitch deck.
**Parameters:**
- `companyName`
- `productService`
- `targetAudience`
- `problemSolution`
- `uniqueValue`
- `signature (required, 0.001 SOL)`


---

## πŸ” Discovery API

Je kunt de actuele tool-definities en prijzen altijd ophalen via ons discovery endpoint:
`https://aifais.com/api/mcp`

---

## πŸ’³ Pricing

Prijzen zijn **Pay-per-Tool** via het X402 protocol.
Sommige tools zijn gratis (factuur/offerte genereren), anderen kosten een klein bedrag in SOL.

**Hoe het werkt:**
1. De agent doet een verzoek zonder `signature`.
2. De server antwoordt met een `402 Error` en geeft een Solana wallet adres + bedrag.
3. Jij (of je agent) betaalt de transactie.
4. De agent stuurt het verzoek opnieuw, maar nu met de `signature`.

Wallet: `Bqpo3emFG46VGLX4korYoeta3a317pWbR2DMbWnFpZ8c`

---

## πŸ› οΈ Lokale Ontwikkeling

```bash
npm install
npm run build
npm start
```

Configuratie via `.env`:
```env
AIFAIS_API_URL=https://aifais.com/api/v1/scan
DEBUG=true
```

---

## πŸͺ΅ Debugging

Zet `DEBUG=true` aan in je environment. Logs worden naar `stderr` geschreven.

---

## πŸ“ Licentie

MIT Β© AIFAIS

---

*Auto-generated from website docs. Version 1.2.0*

TDQS

B3.3/5.0

Scored across 10 tools

Disambiguation4/5

Most tools have distinct purposes targeting specific business tasks like contract analysis, invoice generation, CV screening, and lead scoring. However, create_invoice and scan_invoice could potentially be confused as both handle invoices, though one generates and the other extracts data, which is clarified in descriptions.

Naming Consistency5/5

All tool names follow a consistent verb_noun pattern with snake_case, such as check_contract, create_invoice, and generate_quote. There are no deviations in naming conventions, making the set predictable and readable.

Tool Count5/5

With 10 tools, the count is well-scoped for a business utility server covering various professional tasks like document generation, analysis, and planning. Each tool appears to earn its place without feeling excessive or insufficient.

Completeness3/5

The server covers a broad range of business utilities, but there are notable gaps in lifecycle coverage. For example, tools like check_contract and generate_terms lack corresponding update or delete operations, and there's no clear domain-specific workflow integration, though agents can work around this for standalone tasks.