io.usefulapiPublished by usefulapi.ioOfficial publisherv1.16.4Updated Nov 7, 2026
Read Bilflo clients, contract jobs, contractors and reports; update jobs, terminate or reopen them.
The publisher's own server: Ably MCP by usefulapi
Reads Bilflo staffing data — clients, contract jobs, contractors and reports — and lets an assistant update, terminate or reopen contract jobs.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/io.usefulapi%2Fbilflo/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Add this to your client's mcpServers config.
{
"mcpServers": {
"bilflo-by-usefulapi": {
"type": "http",
"url": "https://bilflo.usefulapi.io/mcp"
}
}
}Read Bilflo clients, contract jobs, contractors and reports; update jobs, terminate or reopen them.
Live endpoint: https://bilflo.usefulapi.io/mcp · Homepage: https://usefulapi.io/bilflo
https://bilflo.usefulapi.io/mcp.claude mcp add --transport http bilflo https://bilflo.usefulapi.io/mcp, then run /mcp to log in.Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Bilflo credentials.
Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/bilflo/
On first connect you'll paste your Bilflo API key (developer.bilflo.com → Credentials) and your Company ID (provided by your staffing company).
read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.
*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].
Pro covers this server only. Subscribe with bilflo_upgrade (it returns a Stripe Checkout link). Cancel any time with bilflo_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running bilflo_upgrade before then undoes the cancel. Or write to [email protected].
MIT © usefulapi. Not affiliated with or endorsed by Bilflo.
Source: servers/bilflo/README.md at commit 4046075
List clients
The staffing company's clients (the customers contractors are placed with): id, business name, client code, phone, active flag. Each row carries the number of addresses and contacts; set include_details for the full address and contact lists. Bilflo returns every client at once, so this tool filters and pages the list itself. GET /v1/Clients.
limitoffsetsearchactive_onlyinclude_detailsGet client
One client with its addresses and contacts. GET /v1/Clients/{clientId}.
client_idrequiredList client contacts
The contacts (people at the client: name, title, phone, email, active flag) of one client. GET /v1/Clients/contact/{clientId}.
client_idrequiredList client addresses
The addresses (work sites and billing addresses) of one client. GET /v1/Clients/addresses/{clientId}.
client_idrequiredList client agreements
The agreements (billing terms) on file for one client. GET /v1/Clients/agreements/{clientId}.
client_idrequiredList client contract POs
The contract purchase orders of one client (PO numbers and amounts used for billing). GET /v1/Clients/contractPOs/{clientId}.
client_idrequiredList client invoice groups
The contract invoice groups of one client (which jobs are invoiced together). GET /v1/Clients/contractInvoiceGroups/{clientId}.
client_idrequiredGet contract job
One contract job (a contractor placed with a client): client, contractor, title, start/end dates, status, overtime rule, timecard method, per-diem/expense/sick-time flags, workers' comp code and burden. GET /v1/ContractJobs/{jobId}.
job_idrequiredList job pay/bill items
The pay and bill rates (pay/bill items such as Regular, Overtime) of one contract job. GET /v1/ContractJobs/{jobId}/payBillItems.
job_idrequiredList job approvers
Who approves the timecards of one contract job. GET /v1/ContractJobs/{jobId}/approvers.
job_idrequiredList job purchase orders
The purchase orders attached to one contract job. GET /v1/ContractJobs/{jobId}/purchaseOrders.
job_idrequiredGet job custom fields
The custom field values of one contract job. GET /v1/ContractJobs/{jobId}/customFields.
job_idrequiredGet direct hire
One direct hire (a permanent placement): header, fee/split data, contacts and custom fields as Bilflo returns them. GET /v1/DirectHires/{jobId}.
job_idrequiredGet contractor
One contractor: profile (name, email, phone, address, W2/1099), jobs, checks paid, work status, benefit settings and custom fields. Social security number, date of birth and bank details are removed from the reply. GET /v1/Users/contractors/{contractorId}.
contractor_idrequiredGet team member
One back-office team member (staffing company user): profile, roles and compensation settings. Government ids and bank details are removed. GET /v1/Users/teamMember/{id}.
team_member_idrequiredList overtime rules
The company's overtime rules (id, name, state). Use the ids with bilflo_update_contract_job. GET /v1/OvertimeRules.
Takes no parameters.
Get company setting
One of the company's lookup lists: workers_comp_codes, payment_terms, remittances, burden_settings, benefit_rules, states or pay_bill_items. GET /v1/CompanySettings/{setting}.
settingrequiredList custom fields
The company's custom fields (active and inactive) with type, requiredness per service offering and, for list fields, the selectable items. GET /v1/CustomFields.
Takes no parameters.
List custom field items
The selectable items of one custom list field (id from bilflo_list_custom_fields). Items of a field named like personal data (SSN, date of birth, bank account, password) are not shown. GET /v1/CustomFields/items.
custom_field_idrequiredRun custom report
Run one of the company's saved custom reports and return its rows. Report parameters are report specific key/value pairs, for example {"Start": "2026-01-01", "End": "2026-01-31"}. Reads data only. POST /v1/Reports/{reportId}/Execute.
report_idrequiredparametersCreate client
WRITE: creates a new client (customer) in Bilflo with the given business name and returns its id. It is visible to the whole staffing company and used for billing, so check bilflo_list_clients first to avoid a duplicate. POST /v1/Clients.
business_namerequiredUpdate client
WRITE: changes only the client fields you pass (business name, client code, phone, fax, active flag); the rest stay as they are. Setting is_active=false deactivates the client. PATCH /v1/Clients/{clientId}.
faxphoneclient_idrequiredis_activeclient_codebusiness_nameUpdate contract job
WRITE: changes only the contract job fields you pass (title, overtime rule, workers' comp code, burden, per-diem/expenses/sick-time/meal-period flags); the rest stay as they are. Pay and bill rates change payroll and invoices, so confirm values with the user. Client, contractor, dates and status cannot be changed here. PATCH /v1/ContractJobs/{jobId}.
job_idrequiredjob_titleburden_manualovertime_rule_idis_allow_skip_lunchis_expenses_enabledis_per_diem_enabledis_sick_time_enabledis_waive_meal_periodworkers_comp_code_idTerminate contract job
WRITE: ends a contract job on the given date (the contractor stops being placed with the client; no more timecards are expected after it). Affects payroll and invoicing. A terminated job can be brought back with bilflo_reopen_contract_job. POST /v1/ContractJobs/terminate.
job_idrequiredend_daterequiredReopen contract job
WRITE: reopens a terminated contract job (like the Open Job button): the job becomes active again, the end date is cleared, the contractor is made active and the missing timecards from the reopen date's week are created. Fails if the job is not terminated or the company plan has no room for another active job. POST /v1/ContractJobs/{jobId}/reopen.
job_idrequiredreopen_daterequiredUpdate contractor contact details
WRITE: changes only the contractor contact fields you pass (name, title, email, phone, address, company); the rest stay as they are. Tax, bank, social security number and activation are not changeable here. PATCH /v1/Users/contractors/{contractorId}.
cityphonetitleaddress1address2zip_codelast_namephone_extfirst_namestate_codemiddle_namecontractor_idrequired+2 more100% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
io.usefulapiOfficial publisher
Hosted MCP server for Ably realtime messaging: inspect channel history, presence and occupancy, publish messages, and review app usage and configuration.
io.usefulapiOfficial publisher
Hosted read-only MCP server that lets an assistant look up Woffu company users, employment contracts, departments and offices.
io.usefulapiOfficial publisher
Hosted MCP server for White Label Loyalty: browse rewards, read a customer's points wallet and tier progress, and buy rewards with points.
io.usefulapiOfficial publisher
Hosted Weekdone connector that lets an assistant read weekly reports, teams, objectives and KPIs, and add report items, comments and KPI values.
io.usefulapiOfficial publisher
Hosted read-only MCP server that lets an assistant list WebinarKit webinars, their dates, series, meetings and white-label sub-accounts.
{ "mcpServers": { "bilflo": { "url": "https://bilflo.usefulapi.io/mcp" } }}