MiJornada MCP by usefulapi

Read employees, work hours, absences, projects and statements to invoice in MiJornada.

Should I use this

Quality & Safety

A
Description quality
100%
Schema completeness
85%
Naming quality
80%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~2,590Tokens (tool definitions)
~1.6 KBTypical response size
Significant attention impact (2.02% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

{
  "mcpServers": {
    "mijornada": {
      "url": "https://mijornada.usefulapi.io/mcp"
    }
  }
}

Remote endpoints

https://mijornada.usefulapi.io/mcpstreamable-http

What it can do

Tool inventory

Tools (11)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢mijornada_get_account

Return the company (name, time zone) and the key this server uses: its scopes and purpose. Use it to test the connection. MiJornada API: GET /me.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢mijornada_list_employees(email, employee_code, worksite_id, status, limit, ...)

List the people in the company, with name, email, employee code, worksite and status. Filter by exact email, employee code, worksite or status. MiJornada API: GET /employees (scope employees:read).

Input Schema

{
  "type": "object",
  "properties": {
    "email": {
      "description": "Exact email address.",
      "type": "string",
      "maxLength": 254,
      "format": "email",
      "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
    },
    "employee_code": {
      "description": "The code the company gave the employee.",
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "worksite_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Worksite id (the MiJornada id)."
    },
    "status": {
      "description": "ACTIVE or ENDED.",
      "type": "string",
      "enum": [
        "ACTIVE",
        "ENDED"
      ]
    },
    "limit": {
      "description": "Items per page, 1-100 (default 50).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "cursor": {
      "description": "The nextCursor of the previous page.",
      "type": "string",
      "minLength": 1,
      "maxLength": 500
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢mijornada_get_employee(employee_id)

Return one employee by id. MiJornada API: GET /employees/{id} (scope employees:read).

Input Schema

{
  "type": "object",
  "properties": {
    "employee_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Employee id (the MiJornada id)."
    }
  },
  "required": [
    "employee_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢mijornada_list_worksites

List the company's workplaces (worksites). Use the ids as worksite_id filters. MiJornada API: GET /worksites (scope employees:read).

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢mijornada_list_workdays(from, to, employee_id, include_timeline, limit, ...)

List one row per person and day: worked minutes, breaks, first clock-in, last clock-out, and whether an approved correction applies. These are the figures in force, so use this for payroll. Window: up to 93 days. Pass include_timeline to add each day's movements. MiJornada API: GET /workdays (scope time:read).

Input Schema

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "First day, in the company time zone."
    },
    "to": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Last day, included. At most 93 days after from."
    },
    "employee_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Only this employee (the MiJornada id)."
    },
    "include_timeline": {
      "description": "Add the day's clock movements to each row.",
      "type": "boolean"
    },
    "limit": {
      "description": "Items per page, 1-100 (default 50).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "cursor": {
      "description": "The nextCursor of the previous page.",
      "type": "string",
      "minLength": 1,
      "maxLength": 500
    }
  },
  "required": [
    "from",
    "to"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢mijornada_list_time_events(from, to, employee_id, source, limit, ...)

List the raw clock events (in, break, out) in time order. Approved corrections do not change these rows: use mijornada_list_workdays for the figures in force. Window: up to 93 days. MiJornada API: GET /time-events (scope time:read).

Input Schema

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "First day, in the company time zone."
    },
    "to": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Last day, included. At most 93 days after from."
    },
    "employee_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Only this employee (the MiJornada id)."
    },
    "source": {
      "description": "Where the clock event was made.",
      "type": "string",
      "enum": [
        "MOBILE",
        "KIOSK",
        "ADMIN",
        "IMPORT",
        "SYSTEM"
      ]
    },
    "limit": {
      "description": "Items per page, 1-100 (default 50).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "cursor": {
      "description": "The nextCursor of the previous page.",
      "type": "string",
      "minLength": 1,
      "maxLength": 500
    }
  },
  "required": [
    "from",
    "to"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢mijornada_list_absences(from, to, employee_id, status, limit, ...)

List vacations and other absences that overlap the range: type, dates, state and days. Medical leave appears as a plain absence, with no reason or documents. Window: up to a year. MiJornada API: GET /absences (scope absences:read).

Input Schema

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "First day, in the company time zone."
    },
    "to": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Last day, included. At most a year after from."
    },
    "employee_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Only this employee (the MiJornada id)."
    },
    "status": {
      "description": "Absence state.",
      "type": "string",
      "enum": [
        "REQUESTED",
        "APPROVED",
        "REJECTED",
        "CANCELLED"
      ]
    },
    "limit": {
      "description": "Items per page, 1-100 (default 50).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "cursor": {
      "description": "The nextCursor of the previous page.",
      "type": "string",
      "minLength": 1,
      "maxLength": 500
    }
  },
  "required": [
    "from",
    "to"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢mijornada_list_clients(include_archived, limit, cursor)

List the clients the company works for. Archived clients are left out unless include_archived is true. MiJornada API: GET /clients (scope projects:read).

Input Schema

{
  "type": "object",
  "properties": {
    "include_archived": {
      "description": "Include archived clients (default false).",
      "type": "boolean"
    },
    "limit": {
      "description": "Items per page, 1-100 (default 50).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "cursor": {
      "description": "The nextCursor of the previous page.",
      "type": "string",
      "minLength": 1,
      "maxLength": 500
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢mijornada_list_projects(status, client_id, limit, cursor)

List the jobs, sites or assignments the company tracks hours against. Filter by state or client. Rates and money budgets appear only when the key has billing:read. MiJornada API: GET /projects (scope projects:read).

Input Schema

{
  "type": "object",
  "properties": {
    "status": {
      "description": "Project state.",
      "type": "string",
      "enum": [
        "ACTIVE",
        "DONE",
        "ARCHIVED"
      ]
    },
    "client_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Only projects of this client (the MiJornada id)."
    },
    "limit": {
      "description": "Items per page, 1-100 (default 50).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "cursor": {
      "description": "The nextCursor of the previous page.",
      "type": "string",
      "minLength": 1,
      "maxLength": 500
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢mijornada_list_project_time(from, to, employee_id, project_id, status, ...)

List minutes per person, day, project and activity. A day's lines add up to the minutes worked that day; time on no project has no project_id. Window: up to 93 days. MiJornada API: GET /project-time (scope projects:read).

Input Schema

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "First day, in the company time zone."
    },
    "to": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Last day, included. At most 93 days after from."
    },
    "employee_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Only this employee (the MiJornada id)."
    },
    "project_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Only this project (the MiJornada id)."
    },
    "status": {
      "description": "Approval state of the hours.",
      "type": "string",
      "enum": [
        "OPEN",
        "APPROVED",
        "BILLED"
      ]
    },
    "limit": {
      "description": "Items per page, 1-100 (default 50).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "cursor": {
      "description": "The nextCursor of the previous page.",
      "type": "string",
      "minLength": 1,
      "maxLength": 500
    }
  },
  "required": [
    "from",
    "to"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢mijornada_list_valuations(from, to, status, limit, cursor)

List issued statements to invoice: approved hours, materials and other lines, priced, with VAT per line. They are not invoices and have no tax validity. Drafts are not listed. Window: up to a year of issue dates. MiJornada API: GET /valuations (scope billing:read).

Input Schema

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "First issue date."
    },
    "to": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Last issue date, included. At most a year after from."
    },
    "status": {
      "description": "Statement state.",
      "type": "string",
      "enum": [
        "ISSUED",
        "INVOICED",
        "VOIDED"
      ]
    },
    "limit": {
      "description": "Items per page, 1-100 (default 50).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "cursor": {
      "description": "The nextCursor of the previous page.",
      "type": "string",
      "minLength": 1,
      "maxLength": 500
    }
  },
  "required": [
    "from",
    "to"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded11 tools