dailytoolkit

dailytoolkit

dailytoolkit is a small local bridge to the hosted FreeDailyPro MCP server, which offers 185 everyday utilities in one surface. Most calls work on data the caller supplies directly — a block of text, a document or media file encoded in the request, a pair of numbers to convert or compare — and return a finished result: counts, converted values, transformed files, or a draft document composed from the caller's own details.

The bridge keeps no data of its own. It serves the upstream server's tool list locally, exactly as captured from the live endpoint, and forwards each tool call upstream, returning the result untouched.

Tools, by family

• Text utilities — word_count, case_convert, generate_slug, reverse_text, sort_text, find_and_replace, diff_text, extract_emails, extract_urls, analyze_readability, keyword_density, fancy_text, invisible_text, text_csv, text_similarity, text_citation, text_paper_format, text_emoji_unicode, and copy helpers such as text_product_description, text_invitation_copy, text_menu_outline, text_flyer_outline, text_banner_copy and text_ascii_art; also check_grammar, paraphrase_text and generate_captions.
• Generators, encoding and developer helpers — generate_password, generate_lorem, generate_uuid, generate_hash, generate_random_numbers, base64, format_json, test_regex, url_encode_decode, convert_timestamp, html_entities, binary_ascii, describe_cron, decode_jwt, markdown_to_html, parse_user_agent, minify_code, apply_timezone_offset, estimate_password_strength, lookup_http_status, generate_meta_tags, hashtags, schema_jsonld, color_convert, contrast_ratio and generate_robots_sitemap.
• Calculators and converters — percentage, calculate_tip, calculate_bmi, calculate_bmr, calculate_ideal_weight, calculate_water_intake, estimate_body_fat, calculate_pregnancy_due_date, calculate_loan, calculate_compound_interest, calculate_simple_interest, calculate_discount, calculate_sales_tax, calculate_age, calculate_gpa, calculate_sip, convert_length, convert_weight, convert_temperature, convert_currency, converters_roman, converters_file_size, converters_paycheck, converters_fire, converters_vat_gst, converters_countdown, converters_401k, converters_rmd, converters_tdee, converters_self_employment_tax, converters_529, converters_social_security, converters_student_loan, converters_amortization, converters_job_experience, US, India, UK and state income-tax converters, converters_college_cost, and scale_recipe.
• PDF tools — form parsing and filling (pdf_parse_fillable_form, pdf_fill_form), pdf_redact, pdf_merge, pdf_split, pdf_rotate, pdf_add_page_numbers, pdf_watermark, pdf_extract_pages, pdf_organize, pdf_flatten, pdf_repair, and a compression range from pdf_compress through lossless black-and-white, greyscale, balanced, aggressive and extreme variants to pdf_compress_size.
• Image, video and audio tools — image_resize, image_crop, image_flip, image_rotate and image_convert; video_convert, video_trim, video_merge, video_extract_audio, video_thumbnail, video_to_gif, video_subtitle and video_compress; audio_convert, audio_trim, audio_merge, audio_compress, audio_normalize, audio_speed, audio_pitch, audio_denoise and audio_remove_silence.
• Planners — planning_packing_list, planning_event_budget, planning_itinerary, planning_event_checklist, planning_event_schedule, planning_guest_list, planning_relocation_checklist, planning_cost_of_living, planning_chores, planning_monthly_budget, planning_grocery_list, planning_inventory, planning_split_bill and planning_travel_countdown.
• Business drafts and figures — business_invoice_totals, business_expenses, business_nda_draft, business_offer_letter_draft, business_bill_of_sale_draft, business_lease_draft, business_promissory_note_draft, business_eviction_notice_draft, business_poa_draft, business_product_margin, business_profit_margin, business_marketplace_fee, business_shipping_estimate, business_break_even, business_startup_names, business_resume_outline, business_cover_letter, business_pay_stub, business_proposal, business_receipt, business_rental_application, business_invention_disclosure, business_contract_pack, business_government_forms, business_bank_statement_to_csv and business_blind_cv. These compose drafts from caller-supplied data; nothing is sent, signed, filed or paid.
• Publishing, ecommerce and codes — publishing_isbn, publishing_spine_width, publishing_print_royalty, publishing_kdp_description, publishing_onix, ecommerce_etsy_listing_check, security_qr and security_barcode_code128.

Configuration

• FREEDAILYPRO_MCP_URL (optional) — override the upstream endpoint. Defaults to https://api.freedailypro.com/mcp. (The override hook is this rebuild's own labelled reconstruction.)
• FREEDAILYPRO_API_KEY (optional) — when set, every upstream request carries an X-API-Key: <key> header. When it is not set, no key header is sent. (This forwarding is also a labelled reconstruction; the original surface was captured keyless.)

Forwarding mechanics

On the first tool call the client opens a streamable HTTP session with the upstream: a JSON-RPC initialize request (protocolVersion 2025-03-26, clientInfo name dailytoolkit), then a notifications/initialized notification, then the tools/call request carrying the caller's arguments unchanged. When the upstream answers initialize with an Mcp-Session-Id header, that value rides on every later request of the session, which is reused for the life of the process. Replies may arrive as plain JSON or as server-sent events; both are read.

Successful upstream results pass through verbatim, including any isError flag the upstream sets. Failures — a JSON-RPC error, a non-2xx status, an unreadable response, or a request that cannot be completed — come back as an isError result whose text starts with dailytoolkit error: (this rendering is this rebuild's own labelled reconstruction).

CLI

Each tool is also a subcommand taking one JSON argument string:

npx @reneturcios/dailytoolkit word_count '{"text":"a short piece of text"}'
npx @reneturcios/dailytoolkit calculate_bmi '{"weight":70,"height":175,"unit":"metric"}'
npx @reneturcios/dailytoolkit convert_currency '{"amount":100,"from":"USD","to":"EUR"}'
npx @reneturcios/dailytoolkit --version

Exit codes: 0 on success, 1 on an isError result, 2 on a usage error.

MCP server

npx -y @reneturcios/dailytoolkit mcp

MCP client config:

{
  "mcpServers": {
    "dailytoolkit": {
      "command": "npx",
      "args": ["-y", "@reneturcios/dailytoolkit", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/dailytoolkit
docker run --rm ghcr.io/cloudcorprecords/dailytoolkit --version

The container's default command is mcp, so the first form is a stdio MCP server; any other arguments reach the CLI normally.

Development

npm install
npm run build
npm test
npm run dev

The test suite runs entirely against a stubbed JSON-RPC upstream — no live network calls.

gen_forward.py is the one-off generator that produced the verbatim TOOL_DEFS literals in src/forward.ts from the captured fixture; it is kept for provenance and is not part of the runtime.

License

MIT — see LICENSE.