Tokei Agent MCP server

Read from the package source without running it. The installed server may list more.

• actions_catalog

  List every entry-action type entry actions can use: label, description, default points, platform, and whether it's trust-based / API-verifiable / manually verifiable. Same catalog for every key — not scoped to your account. Optional type argument returns just that one action type's entry; a value matching no known type is a 400.

• entries_createwrite action

  Add an entry (signup) to a page. Duplicate email for the page returns 409 — the person is already signed up. Needs a read+write key.

• entries_list

  List a page's entries (signups). Filter by exact email with the email argument.

• events_catalog

  List every webhook event type Tokei's delivery engine understands: description, payload schema, and whether it's currently subscribable. Same catalog for every key — not scoped to your account. Optional type argument returns just that one event type's entry; a value matching no known type is a 400.

• leaderboard

  Participants of a page ranked by entry points.

• me

  Verify the API key and return account information: plan, API usage today, active page count.

• media_uploadwrite action

  Upload an image or video from local disk (one multipart POST) and return a public_url to feed into pages_update's seven media fields (image_video, secondary_image, third_image, fourth_image, fifth_image, background_image, og_image). Content type is inferred from the file extension (.jpg/.jpeg/.png/.gif/.webp/.mp4/.webm/.mov); override with content_type. Uploads are capped at 5MB — applies to video

• pages_clonewrite action

  Create a page by cloning one you own (source_promotion_id), a named platform template (template — list slugs with templates_list), or the platform starter template (omit both). Sending both source_promotion_id and template is a 422. Template, theme, and entry methods copy verbatim from the source. Capped at 20 API-created pages per account per UTC day (429). Needs a read+write key.

• pages_get

  Get one page in full: description, prizes, reward_thresholds, dates, public_url.

• pages_list

  List your pages (API: promotions/contests) with status, entry counts, and public URLs.

• pages_publishwrite action

  Publish a page (status -> active), making it live at its public_url. Requires an end_date in the future — either already stored on the page or supplied here — otherwise returns 422 VALIDATION_ERROR. Re-publishing an already-active page is a no-op and skips that check. Needs a read+write key.

• pages_unpublish

  Unpublish a page (status -> draft): blocks new entries only — existing entries and entrants are untouched, nothing is deleted. IMPORTANT: a draft page still renders publicly at its URL; unpublishing does not hide it from anyone with the link, it only stops new signups. It is not a way to take a page down. Needs a read+write key.

• pages_updatewrite action

  Update a page: title, description, start/end dates, prizes, reward tiers, entry methods (the action buttons on the page), appearance, and the seven media slots (image_video, secondary_image, third_image, fourth_image, fifth_image, background_image, og_image — use media_upload to get a public_url first). At least one field; unknown fields are rejected (422). prizes, reward_thresholds and entry_meth

• referrals_topwrite action

  A page's top referrers, ranked by converted referrals, with each one's referral code, name, email and counts — plus totals for referral clicks and conversion rate. Only entrants who have referred at least one person are listed.

• stats

  Aggregated analytics for a page: signups, entries, referrals, top actions.

• surveys_list

  List survey responses for a page.

• templates_list

  List the platform's named starting points: id, slug, name, skin (page layout), and entry_method_count. Same list for every key. Clone one by slug with pages_clone's template argument.

• webhooks_createwrite action

  Subscribe an HTTPS endpoint to events. The response contains the whsec_ signing secret EXACTLY ONCE — store it immediately, it cannot be retrieved again. Deliveries are HMAC-SHA256 signed (X-TOKEI-Signature). Needs a read+write key.

• webhooks_deletewrite action

  Delete a webhook subscription. Its queued and historical delivery records are deleted with it (webhook_deliveries cascades on the subscription), so past delivery attempts are no longer retrievable afterwards. A 404 usually means it was already deleted — safe to treat as success.

• webhooks_list

  List webhook subscriptions. failure_count is consecutive failed deliveries — auto-disabled at 10.

• winners_listwrite action

  Selection-run history for a page (newest first): each run's id, seed, algorithm version, status, requested_by_email, total_candidates/total_winners_selected, and its persisted winners — each with entrant identity (email, full_name, entry_points, created_at, country_name, city) and prize details (prize_tier, prize_description, prize_value, selected_at, notified_at, notification_method, verified, cl

• Code scan14 source files scanned25/25
• –Live reliabilityno gateway calls yet and no remote to proben/a
• –Tool poisoningtools not inspected (local package is not executed); not countedn/a
• Auth qualitystatic API keys via environment variables6/15
• Maintenancelast push 15 days ago15/15
• Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10

Tokei Agent: common questions

Is Tokei Agent MCP server safe?

Mostly: it is graded B (83/100). Read the Tokei Agent safety report

How do I install Tokei Agent?

It runs on your machine. Copy the Claude Code, Claude Desktop or Cursor config from the install section.

Does Tokei Agent need an API key?

Yes. The registry entry asks for TOKEI_API_KEY.

Is Tokei Agent maintained?

The last commit was 16 days ago (2026-09-04). The latest release is v0.3.6.

What can I use instead of Tokei Agent?

Servers from other publishers that do the same job: agent-device MCP server and Munim Computer Use MCP server.