# Bill4Time MCP by usefulapi (remote · bill4time.usefulapi.io)

Read Bill4Time clients, projects, time entries, expenses, invoices, payments, users and contacts.

- Trust score: 62/100 (medium)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-10-17

## Components

- remote · `bill4time.usefulapi.io`: 62/100 (this document), [markdown](https://verifymcp.io/servers/io-usefulapi-bill4time/bill4time.md), [page](https://verifymcp.io/servers/io-usefulapi-bill4time/bill4time)

## Channel facts

- Endpoint: `https://bill4time.usefulapi.io/mcp`
- Transports: `streamable-http`
- Auth: `required`
- Version: `1.0.0`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-10-17.

- **Endpoint Security**: 78/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation is enforced on tool calls, advertised via RFC 9728 protected-resource metadata. Discovery is public, which costs nothing: no tool can be invoked without a token.
  - HTTPS enforcement could not be verified: the plaintext port redirected somewhere other than https, so enforcement is unproven.
  - HSTS check failed: the Strict-Transport-Security header is absent.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
  - The authorisation server offers only Dynamic Client Registration (RFC 7591), which MCP 2026-07-28 deprecated in favour of Client ID Metadata Documents.
- **Transport & Reachability**: 0/100
  - Transport check failed: declared streamable-http, but the endpoint redirected instead of responding directly.
- **Schema Quality & AI Usability**: 70/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 2170 tokens (~271/item across 8 items; 8 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 17/100
  - Stability observed for 5 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 93/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 80% of tool parameters carry a description.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 8 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 9 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 60/100
  - Spec-recency check failed: implements MCP spec 2025-06-18; the latest is 2026-07-28.

## Install

### How do I install the Bill4Time MCP by usefulapi server?

Bill4Time MCP by usefulapi is a hosted endpoint at https://bill4time.usefulapi.io/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add --transport http io-usefulapi-bill4time 'https://bill4time.usefulapi.io/mcp'
```

### Cursor

```json
{
  "mcpServers": {
    "io-usefulapi-bill4time": {
      "url": "https://bill4time.usefulapi.io/mcp"
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "io-usefulapi-bill4time": {
      "type": "http",
      "url": "https://bill4time.usefulapi.io/mcp"
    }
  }
}
```

### Codex

```toml
[mcp_servers.io-usefulapi-bill4time]
url = "https://bill4time.usefulapi.io/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "io-usefulapi-bill4time": {
      "type": "remote",
      "url": "https://bill4time.usefulapi.io/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add io-usefulapi-bill4time --url 'https://bill4time.usefulapi.io/mcp' --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  io-usefulapi-bill4time:
    url: "https://bill4time.usefulapi.io/mcp"
```

### Netclaw

```json
{
  "McpServers": {
    "io-usefulapi-bill4time": {
      "Transport": "http",
      "Url": "https://bill4time.usefulapi.io/mcp"
    }
  }
}
```

### Vellum

```bash
assistant mcp add io-usefulapi-bill4time -t streamable-http -u 'https://bill4time.usefulapi.io/mcp'
```

### Other

```json
{
  "mcpServers": {
    "io-usefulapi-bill4time": {
      "type": "http",
      "url": "https://bill4time.usefulapi.io/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-10-17 (score 62, +1)

No change was recorded against any check on this day. Stability & Change Management went from 13 to 17. That category is still filling its 30-day observation window: 4 days of observed history at the previous scan, 5 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-10-14 (score 61, +1)

No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-10-13 (score 60, +3)

- [security] The server rewrote its instructions, which are the text every model session reads
- [functional improvement] Stability: unverified → 0.03
- [functional] The server now declares the “prompts” capability
- [functional] First check of Schema quality: 100
- [functional] New prompt “getting_started”
- [functional] Server version: 1.0.0 → 1.1.0

### 2026-10-12 (score 57)

First indexed and scored.

## MCP tools (8)

### `bill4time_list_clients` (~234 tokens)

List clients

List clients (id, name, billing name, email, phone, city, account manager, status, billing rate type, currency). Filter by status, exact client name, id or creation date. Street addresses and tax ids are not returned. GET /clients.

Input parameters:

- `client_name` (string): Exact client name (case rules are Bill4Time's).
- `created_after` (string): Clients created on or after this date.
- `created_before` (string): Clients created on or before this date.
- `descending` (boolean): Sort descending (newest or highest first). Default ascending.
- `id` (integer): Only the record with this id.
- `include_custom_fields` (boolean): Also return the custom fields (default false).
- `skip` (integer): Records to skip (default 0). Pass the previous reply's next_skip to read the next page.
- `sort` (string): Field to sort by (default: Bill4Time's own order).
- `status` (string)
- `top` (integer): Records to return, 1-100 (default 25).

### `bill4time_list_projects` (~231 tokens)

List projects (matters)

List projects (matters): id, name, client, status, billing method, rate overrides, assigned user, created/closed/due dates. Filter by status, billing method, client, id or creation date. GET /projects.

Input parameters:

- `billing_method` (string)
- `client_id` (integer): Only projects of this client.
- `created_after` (string): Projects created on or after this date.
- `created_before` (string): Projects created on or before this date.
- `descending` (boolean): Sort descending (newest or highest first). Default ascending.
- `id` (integer): Only the record with this id.
- `include_custom_fields` (boolean): Also return the custom fields (default false).
- `skip` (integer): Records to skip (default 0). Pass the previous reply's next_skip to read the next page.
- `sort` (string): Field to sort by (default: Bill4Time's own order).
- `status` (string)
- `top` (integer): Records to return, 1-100 (default 25).

### `bill4time_list_time_entries` (~320 tokens)

List time entries

List time entries: client, project, user, entry date, billable and labor time, billable amount, rate, activity, ABA litigation code, billing status, invoice id, public description. Filter by client, project, user, invoice, entry date range or billing status. Private notes and contractor pay rates are not returned unless include_private_notes is set. GET /timeEntries.

Input parameters:

- `activity_type` (string): Exact activity type name.
- `billing_status` (string)
- `client_id` (integer)
- `date_from` (string): Entries dated on or after this date.
- `date_to` (string): Entries dated on or before this date.
- `descending` (boolean): Sort descending (newest or highest first). Default ascending.
- `id` (integer): Only the record with this id.
- `include_custom_fields` (boolean): Also return the custom fields (default false).
- `include_private_notes` (boolean): Also return the private/internal notes (default false). Only set it when the user asks for internal notes.
- `invoice_id` (integer): Only entries on this invoice.
- `project_id` (integer)
- `skip` (integer): Records to skip (default 0). Pass the previous reply's next_skip to read the next page.
- `sort` (string): Field to sort by (default: Bill4Time's own order).
- `top` (integer): Records to return, 1-100 (default 25).
- `user_id` (integer)

### `bill4time_list_expenses` (~323 tokens)

List expenses

List expenses: client, project, user, expense date, cost and sell price, quantity, type, billing status, invoice id, public description. Filter by client, project, user, invoice, expense date range, billing status or exact expense type. Private notes are not returned unless include_private_notes is set. GET /expenses.

Input parameters:

- `billing_status` (string)
- `client_id` (integer)
- `date_from` (string): Expenses dated on or after this date.
- `date_to` (string): Expenses dated on or before this date.
- `descending` (boolean): Sort descending (newest or highest first). Default ascending.
- `expense_type` (string): Exact expense type name.
- `id` (integer): Only the record with this id.
- `include_custom_fields` (boolean): Also return the custom fields (default false).
- `include_private_notes` (boolean): Also return the private/internal notes (default false). Only set it when the user asks for internal notes.
- `invoice_id` (integer): Only expenses on this invoice.
- `project_id` (integer): A project id, or -1 for expenses that belong to no project.
- `skip` (integer): Records to skip (default 0). Pass the previous reply's next_skip to read the next page.
- `sort` (string): Field to sort by (default: Bill4Time's own order).
- `top` (integer): Records to return, 1-100 (default 25).
- `user_id` (integer)

### `bill4time_list_invoices` (~246 tokens)

List invoices

List invoices: client, project, invoice date, status (prebill or finalized), paid status, totals (invoice, labor, expense, late fee), terms and notes. Filter by status, paid status, client, project, id or invoice date range. GET /invoices.

Input parameters:

- `client_id` (integer)
- `date_from` (string): Invoices dated on or after this date.
- `date_to` (string): Invoices dated on or before this date.
- `descending` (boolean): Sort descending (newest or highest first). Default ascending.
- `id` (integer): Only the record with this id.
- `include_custom_fields` (boolean): Also return the custom fields (default false).
- `paid_status` (string)
- `project_id` (integer)
- `skip` (integer): Records to skip (default 0). Pass the previous reply's next_skip to read the next page.
- `sort` (string): Field to sort by (default: Bill4Time's own order).
- `status` (string)
- `top` (integer): Records to return, 1-100 (default 25).

### `bill4time_list_payments` (~233 tokens)

List payments

List payments: client, project, amount, date, type, method, public note. Filter by client, project, id or payment date range. Check numbers are not returned; the private note only with include_private_notes. GET /payments.

Input parameters:

- `client_id` (integer)
- `date_from` (string): Payments dated on or after this date.
- `date_to` (string): Payments dated on or before this date.
- `descending` (boolean): Sort descending (newest or highest first). Default ascending.
- `id` (integer): Only the record with this id.
- `include_private_notes` (boolean): Also return the private/internal notes (default false). Only set it when the user asks for internal notes.
- `project_id` (integer)
- `skip` (integer): Records to skip (default 0). Pass the previous reply's next_skip to read the next page.
- `sort` (string): Field to sort by (default: Bill4Time's own order).
- `top` (integer): Records to return, 1-100 (default 25).

### `bill4time_list_users` (~180 tokens)

List users (timekeepers)

List the firm's users: name, email, user type, status, department, position, billing and overtime rate. Birth dates, addresses, phone numbers and contractor pay rates are not returned. Filter by status or id. GET /users.

Input parameters:

- `descending` (boolean): Sort descending (newest or highest first). Default ascending.
- `id` (integer): Only the record with this id.
- `include_custom_fields` (boolean): Also return the custom fields (default false).
- `skip` (integer): Records to skip (default 0). Pass the previous reply's next_skip to read the next page.
- `sort` (string): Field to sort by (default: Bill4Time's own order).
- `status` (string)
- `top` (integer): Records to return, 1-100 (default 25).

### `bill4time_list_contacts` (~188 tokens)

List contacts

List contacts: name, email, work and mobile phone, city, status, creation date. Filter by status, id or creation date. Street addresses, home phone and notes are not returned. GET /contacts.

Input parameters:

- `created_after` (string): Contacts created on or after this date.
- `created_before` (string): Contacts created on or before this date.
- `descending` (boolean): Sort descending (newest or highest first). Default ascending.
- `id` (integer): Only the record with this id.
- `skip` (integer): Records to skip (default 0). Pass the previous reply's next_skip to read the next page.
- `sort` (string): Field to sort by (default: Bill4Time's own order).
- `status` (string)
- `top` (integer): Records to return, 1-100 (default 25).

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/io-usefulapi-bill4time/bill4time#diagnostics

## Score history

- 2026-10-17: 62
- 2026-10-16: 61
- 2026-10-15: 61
- 2026-10-14: 61
- 2026-10-13: 60
- 2026-10-12: 57

## Common questions

### What is the Bill4Time MCP by usefulapi server?

Bill4Time MCP by usefulapi is listed in the public MCP registry as io.usefulapi/bill4time. Read Bill4Time clients, projects, time entries, expenses, invoices, payments, users and contacts. This page covers its hosted endpoint (https://bill4time.usefulapi.io/mcp).

### Is the Bill4Time MCP by usefulapi server safe to use?

Bill4Time MCP by usefulapi scores 62 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the Bill4Time MCP by usefulapi server expose?

Bill4Time MCP by usefulapi exposes 8 tools: bill4time_list_clients, bill4time_list_projects, bill4time_list_time_entries, bill4time_list_expenses, bill4time_list_invoices, and 3 more. Their descriptions and schemas cost roughly 1,955 tokens of context every time the server is loaded.

### Does the Bill4Time MCP by usefulapi server require authentication?

Yes. Bill4Time MCP by usefulapi asked us for credentials when we connected, so you will need to authorise it in your MCP client before it can do anything.

### Is the Bill4Time MCP by usefulapi server still maintained?

Bill4Time MCP by usefulapi is still listed as active in the MCP registry. We last reached this channel on 17 October 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

## Links

- Remote endpoint: https://bill4time.usefulapi.io/mcp
- Repository: https://github.com/m190/usefulapi-mcp
- Website: https://usefulapi.io/bill4time/
- Changelog RSS feed: https://verifymcp.io/servers/io-usefulapi-bill4time/bill4time.xml
- Changelog JSON feed: https://verifymcp.io/servers/io-usefulapi-bill4time/bill4time.json
- HTML version of this page: https://verifymcp.io/servers/io-usefulapi-bill4time/bill4time