aifais-mcp-server
# 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
Scored across 10 tools
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.
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.
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.
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.