MCP server
Artesa MCP by usefulapi
Read customers, assignments, staff, time entries and absences; create customers in Artesa.
- Runs
- Remotely
- Version
- 1.7.0
- Listing updated
- 4 days ago
About Artesa MCP by usefulapi
Artesa MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.
Install
Run in a terminal
claude mcp add --transport http artesa https://artesa.usefulapi.io/mcpAdd to Settings → Connectors → Add custom connector
https://artesa.usefulapi.io/mcpInstall in CursorOpens Cursor, which asks you to confirm. Or add it by hand:
Add to ~/.cursor/mcp.json
{
"mcpServers": {
"artesa": {
"url": "https://artesa.usefulapi.io/mcp"
}
}
}Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:
Add to .vscode/mcp.json
{
"servers": {
"artesa": {
"type": "http",
"url": "https://artesa.usefulapi.io/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"artesa": {
"serverUrl": "https://artesa.usefulapi.io/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"artesa": {
"type": "http",
"url": "https://artesa.usefulapi.io/mcp"
}
}
}Tools this server provides (18)
Read directly from the server.
- artesa_list_customers
- List customers (private persons or companies that assignments are carried out for). Filter by company name, number or external id. Artesa API: GET /v2/customers.
- artesa_get_customer
- Get one customer with its phones, emails, URLs and billing address. Artesa API: GET /v2/customers/{customerUuid}.
- artesa_create_customer
- Create a new customer record (company or private person). Not safe to retry: a retry creates a second customer. Artesa API: POST /v2/customers.
- artesa_list_assignments
- List assignments (orders/jobs) with their customer, project, type, responsible user and status. Artesa API: GET /v2/assignments.
- artesa_get_assignment
- Get one assignment with its details. Artesa API: GET /v2/assignments/{assignmentUuid}.
- artesa_list_assignment_events
- List work steps (appointments and events) of assignments, optionally in a time window. Artesa API: GET /v2/assignment-events.
- artesa_get_assignment_event
- Get one assignment event (work step). Artesa API: GET /v2/assignment-events/{assignmentEventUuid}.
- artesa_list_projects
- List projects that group assignments. Artesa API: GET /v2/projects.
- artesa_get_project
- Get one project. Artesa API: GET /v2/projects/{projectUuid}.
- artesa_list_users
- List users (staff members) with their role. Filter by name, email or role. Artesa API: GET /v2/users.
- artesa_get_user
- Get one user (staff member). Artesa API: GET /v2/users/{userUuid}.
- artesa_list_time_entries
- List recorded time entries (work time) per user, assignment or event, optionally in a time window. Artesa API: GET /v2/time-entries.
- artesa_list_user_absences
- List absences (holidays, sick days and similar) of users in a time window. Artesa API: GET /v2/user-absences.
- artesa_list_time_sheet_weeks
- List weekly time sheets per user, with their status. Artesa API: GET /v2/time-sheet-weeks.
- artesa_list_assignment_status_types
- List the assignment status types (Auftragsstatus) your company uses. Artesa API: GET /v2/assignment-status-types.
- artesa_list_assignment_types
- List the assignment types (Auftragstypen) your company uses. Artesa API: GET /v2/assignment-types.
- artesa_list_gangs
- List gangs (work crews or teams) of your company. Artesa API: GET /v2/gangs.
- artesa_list_roles
- List the user roles (Benutzerrollen) of your company. Artesa API: GET /v2/roles.
Artesa MCP by usefulapi FAQ
How do I add Artesa MCP by usefulapi to Claude Code?
Run this command in your terminal: claude mcp add --transport http artesa https://artesa.usefulapi.io/mcp