{"data":{"name":"com.shotpulled/shotpulled","title":"ShotPulled","description":"Espresso dialing: log a shot, say how it tasted, get one change in your grinder's own clicks.","version":"1.4.2","websiteUrl":"https://shotpulled.com","repositoryUrl":null,"remotes":[{"type":"streamable-http","url":"https://mcp.shotpulled.com/mcp"}],"packages":[],"status":"active","isLatest":true,"publishedAt":"2026-10-26T11:42:43.407Z","updatedAt":"2026-10-26T11:42:43.407Z","source":"official-registry","verification":"official","confidence":100,"stars":null,"sources":[{"source":"official-registry","sourceId":"com.shotpulled/shotpulled","verification":"official","confidence":100,"stars":null,"updatedAt":"2026-10-26T11:42:43.407Z","title":"ShotPulled","description":"Espresso dialing: log a shot, say how it tasted, get one change in your grinder's own clicks.","websiteUrl":"https://shotpulled.com","repositoryUrl":null}],"toolIndex":{"tools":[{"serverName":"com.shotpulled/shotpulled","endpointFingerprint":"4f7536feb2c5f3000c36b0b7f69c27d8c420518af9845f19cbb05fd50af49232","name":"compute_age","title":"Compute coffee age","description":"Compute a bag's age in days off roast and its resting/staling verdict, for the coffee's current bag by default or for the bag named.","inputSchema":{"type":"object","properties":{"bean_id":{"type":"integer"},"bag_id":{"type":["integer","null"],"description":"A bag of that coffee (from list_beans' bags[]); null = its current bag"}},"required":["bean_id"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"e24d6f5b68a0f467d0a75aed3a603170d6e174772ccf2919b7e70fd57fc305a0","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T23:46:56.684Z","metadataTrust":"untrusted"},{"serverName":"com.shotpulled/shotpulled","endpointFingerprint":"4f7536feb2c5f3000c36b0b7f69c27d8c420518af9845f19cbb05fd50af49232","name":"delete_shot","title":"Delete a shot","description":"Delete a logged shot from history. Restores the bean's remaining weight (which is derived from logged doses). Hard delete: there is no undo. To fix a mistake on an otherwise-valid shot, prefer update_shot over delete-and-relog.","inputSchema":{"type":"object","properties":{"shot_id":{"type":"integer","description":"ID of the shot to delete"}},"required":["shot_id"]},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false},"definitionHash":"0b17f4000d728b8cd8ea916020f5fe13ea5dab373c3827780b54401e7be9a209","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T23:46:56.684Z","metadataTrust":"untrusted"},{"serverName":"com.shotpulled/shotpulled","endpointFingerprint":"4f7536feb2c5f3000c36b0b7f69c27d8c420518af9845f19cbb05fd50af49232","name":"diagnose_preview","title":"Preview a diagnosis","description":"Sandbox-only diagnosis, writes nothing (no verdict, no recommendation-trail entry). Two modes: pass shot_id to dry-run a LOGGED shot (optionally overriding its sensory_tags, for the \"what would this read as?\" preview; the shot's own bean and its age at pulled_at are used), or pass the full metric set (bean_id, grinder_id, machine_id, grind_label, dose_g, yield_g, time_s, source) for a hypothetical shot. Identical output shape to diagnose_shot, including bean_context.","inputSchema":{"type":"object","properties":{"shot_id":{"type":"integer","description":"Preview a logged shot by ID (dry-run; ignores the metric params below)"},"bean_id":{"type":"integer","description":"Coffee bean ID (must belong to this account)"},"grinder_id":{"type":"integer","description":"Grinder ID (must belong to this account)"},"machine_id":{"type":"integer","description":"Machine ID (must belong to this account)"},"grind_label":{"type":"string","description":"Grinder setting label, e.g. \"1.1.3\""},"dose_g":{"type":"number","description":"Dose in grams"},"yield_g":{"type":"number","description":"Yield in grams"},"time_s":{"type":"number","description":"Extraction time in seconds"},"source":{"type":"string","enum":["measured","recalled","assumed"],"description":"Grinder position source. Affects G1 warning (raw mode only)"},"sensory_tags":{"type":"array","items":{"type":"string"},"description":"Sensory observations, e.g. [\"sour\",\"bitter\"]. With shot_id: replaces the stored tags for this preview (omit to use stored; [] = none)."}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"324518fedab9930984ac27762b4562aea76ddadfedb773b8b5e38aa1b321d25e","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T23:46:56.684Z","metadataTrust":"untrusted"},{"serverName":"com.shotpulled/shotpulled","endpointFingerprint":"4f7536feb2c5f3000c36b0b7f69c27d8c420518af9845f19cbb05fd50af49232","name":"diagnose_shot","title":"Diagnose a shot","description":"Evaluate shot metrics to provide ranked hypotheses (C6) and warn on flip-flops (G2) or fatigue (G6). Resolves the SHOT's own bean (age computed at the shot's pulled_at), never the active profile, and echoes it as bean_context, so diagnosing an older or differently-filed shot is always safe. The engine reads metrics and sensory tags, NOT free-text notes, so make sure taste feedback is recorded as sensory_tags on the shot (via log_shot or update_shot) before diagnosing; otherwise an in-range shot that tastes bad will come back \"balanced\".","inputSchema":{"type":"object","properties":{"shot_id":{"type":"integer","description":"Optional shot ID; defaults to last pulled shot."}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"fd1c1236f510fc6abf658c701b8378fea130140ccf7d170f98b44b724ec1fd92","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T23:46:56.684Z","metadataTrust":"untrusted"},{"serverName":"com.shotpulled/shotpulled","endpointFingerprint":"4f7536feb2c5f3000c36b0b7f69c27d8c420518af9845f19cbb05fd50af49232","name":"get_dial_state","title":"Get current dial state","description":"Retrieve current dialing state, active context, recent shots, recommendations, and locked recipes.","inputSchema":{"type":"object","properties":{}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"071b12aab531b8698a8d0546615004dec98376f953d42ef2acedf05e9034c5e2","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T23:46:56.684Z","metadataTrust":"untrusted"},{"serverName":"com.shotpulled/shotpulled","endpointFingerprint":"4f7536feb2c5f3000c36b0b7f69c27d8c420518af9845f19cbb05fd50af49232","name":"get_kb_version","title":"Get knowledge base version","description":"Retrieve the current version of the knowledge base.","inputSchema":{"type":"object","properties":{}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"e410429b434f7c62fd4298c492f497be865670413e46ddea209802902b1871e1","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T23:46:56.684Z","metadataTrust":"untrusted"},{"serverName":"com.shotpulled/shotpulled","endpointFingerprint":"4f7536feb2c5f3000c36b0b7f69c27d8c420518af9845f19cbb05fd50af49232","name":"get_maintenance_guides","title":"Get maintenance guides","description":"Step-by-step maintenance guides: tools, supplies, steps and warnings, in our own words with the maker's documents as sources. With no arguments, every guide for the user's current grinders and machines (and the water filter fitted in each). With guide_ids, those guides; the ids come from maintenance.tasks[].guide.id in list_grinders and list_machines. Ids that match no guide are listed under missing.","inputSchema":{"type":"object","properties":{"guide_ids":{"type":"array","items":{"type":"string"},"maxItems":50,"description":"Optional: the guides to fetch. Omit for every guide the user's equipment can use"}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"e4ac1f6c5484e66711d812c35d37c5b1d8c2ecfea2db06c9ee3bac92e395565a","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T23:46:56.684Z","metadataTrust":"untrusted"},{"serverName":"com.shotpulled/shotpulled","endpointFingerprint":"4f7536feb2c5f3000c36b0b7f69c27d8c420518af9845f19cbb05fd50af49232","name":"get_rule","title":"Get a dialing rule","description":"Retrieve the detailed text of a specific rule from the knowledge base by its rule ID.","inputSchema":{"type":"object","properties":{"rule_id":{"type":"string","description":"The ID of the rule to fetch, e.g. CAT.DARK"}},"required":["rule_id"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"bf80a53065468dbb164e27ec352b7b40ea0dc6a2d21862265cb8e02b5f73c101","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T23:46:56.684Z","metadataTrust":"untrusted"},{"serverName":"com.shotpulled/shotpulled","endpointFingerprint":"4f7536feb2c5f3000c36b0b7f69c27d8c420518af9845f19cbb05fd50af49232","name":"get_stats","title":"Get statistics","description":"Get compact flat usage stats for a grinder, machine, or bean.","inputSchema":{"type":"object","properties":{"scope":{"type":"string","enum":["grinder","machine","bean"],"description":"The stats scope"},"id":{"type":"integer","description":"The entity ID"}},"required":["scope","id"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"ab16c4a396ff391f2ee3d23b0bf1a7787e2596c889fc891a39cad5e210b9cffa","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T23:46:56.684Z","metadataTrust":"untrusted"},{"serverName":"com.shotpulled/shotpulled","endpointFingerprint":"4f7536feb2c5f3000c36b0b7f69c27d8c420518af9845f19cbb05fd50af49232","name":"grinder_math","title":"Grinder math","description":"Determine steps/clicks difference and directions between setting labels (C3).","inputSchema":{"type":"object","properties":{"grinder_id":{"type":"integer"},"from_label":{"type":"string"},"to_label":{"type":"string"}},"required":["grinder_id","from_label","to_label"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"f5b2699ec435034416f63bd5af8fa2d0a7a46f27d9e67df9bf5edeaa3378a3c9","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T23:46:56.684Z","metadataTrust":"untrusted"},{"serverName":"com.shotpulled/shotpulled","endpointFingerprint":"4f7536feb2c5f3000c36b0b7f69c27d8c420518af9845f19cbb05fd50af49232","name":"kb_changelog","title":"Knowledge base changelog","description":"Retrieve the changelog showing updates and version differences for the knowledge base.","inputSchema":{"type":"object","properties":{}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"a11d4ceab279e56631434dc392dbdf2bb8cfac4f4ce5569c707a4cd9bc30c76e","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T23:46:56.684Z","metadataTrust":"untrusted"},{"serverName":"com.shotpulled/shotpulled","endpointFingerprint":"4f7536feb2c5f3000c36b0b7f69c27d8c420518af9845f19cbb05fd50af49232","name":"list_beans","title":"List coffees","description":"List the coffees registered for the account, with status filter. Each coffee carries its bags[] (every purchase, with its own freshness and grams left) and current_bag_id; the row's top-level roast_date, state, grams_remaining and age fields are the current bag's. The `id` on each row is the number this account knows that coffee by, counting from 1: safe to show, and what other tools expect back; bag ids are a separate series.","inputSchema":{"type":"object","properties":{"status":{"type":"string","enum":["current","archived","all"],"description":"Filter by status: current, archived, or all. Defaults to current."}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"93cae8aff70de4d180d1dad012ba563bcaa3e68d6f061f7fa9526d59e8f4ce74","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T23:46:56.684Z","metadataTrust":"untrusted"},{"serverName":"com.shotpulled/shotpulled","endpointFingerprint":"4f7536feb2c5f3000c36b0b7f69c27d8c420518af9845f19cbb05fd50af49232","name":"list_grinders","title":"List grinders","description":"List grinders registered for the account, with status filter. The `id` on each row is the number this account knows that record by, counting from 1: safe to show, and what other tools expect back. Each row carries its maintenance block: every task with its class (S schedule, H habit, Y symptom, A the machine signals it, T technician, N never, U unstated, E event), due state, and the guide to follow.","inputSchema":{"type":"object","properties":{"status":{"type":"string","enum":["current","archived","all"],"description":"Filter by status: current, archived, or all. Defaults to current."},"maintenance":{"type":"string","enum":["compact","full"],"description":"How much of each row's maintenance block to include. compact (default): every task with its class, due state, schedule and guide. full: also the maker's own words (quote, source, alternates, the interval as written)."}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"4dbb8ddedcca529d5455d8f7498ee96f3200d041359fff3a74d7970e71e9b5ad","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T23:46:56.684Z","metadataTrust":"untrusted"},{"serverName":"com.shotpulled/shotpulled","endpointFingerprint":"4f7536feb2c5f3000c36b0b7f69c27d8c420518af9845f19cbb05fd50af49232","name":"list_machines","title":"List espresso machines","description":"List machines registered for the account, with status filter. The `id` on each row is the number this account knows that record by, counting from 1: safe to show, and what other tools expect back. Each row carries its maintenance block, researched per model: every task with its class, due state, what the maker forbids, and the guide to follow. `settings` lists the selectors its model has and where each stands (null: unknown model, or none).","inputSchema":{"type":"object","properties":{"status":{"type":"string","enum":["current","archived","all"],"description":"Filter by status: current, archived, or all. Defaults to current."},"maintenance":{"type":"string","enum":["compact","full"],"description":"How much of each row's maintenance block to include. compact (default): every task with its class, due state, schedule and guide. full: also the maker's own words (quote, source, alternates, the interval as written)."}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"7cd5371bfdc5e279aaeb64549c6244225cae3f9e1e316328e40747c9eca87ab7","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T23:46:56.684Z","metadataTrust":"untrusted"},{"serverName":"com.shotpulled/shotpulled","endpointFingerprint":"4f7536feb2c5f3000c36b0b7f69c27d8c420518af9845f19cbb05fd50af49232","name":"list_maintenance_due","title":"List maintenance due","description":"What maintenance is due across the user's current grinders and machines, most urgent first. Use it for \"is anything due?\". Only tasks with an interval compete: a task the machine counts and signals itself, one done by habit or when a symptom shows, and one the maker advises against never appear. Each item says how far along it is (ratio, done of every, on which basis), whether it is coming up (soon), and whether the interval is the user's, the maker's or ShotPulled's default.","inputSchema":{"type":"object","properties":{"status":{"type":"string","enum":["due","all"],"description":"due (default): due or overdue, and not muted. all: every scheduled task, muted ones last"}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"5cbf90c65e6aac42df25b6c72763ca59a7d54d23bab981da209be9139e7decfe","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T23:46:56.684Z","metadataTrust":"untrusted"},{"serverName":"com.shotpulled/shotpulled","endpointFingerprint":"4f7536feb2c5f3000c36b0b7f69c27d8c420518af9845f19cbb05fd50af49232","name":"list_recipes","title":"List locked recipes","description":"List recipes (all or filtered by equipment and status). The `id` on each row is the number this account knows that record by, counting from 1: safe to show, and what other tools expect back.","inputSchema":{"type":"object","properties":{"bean_id":{"type":"integer"},"grinder_id":{"type":"integer"},"machine_id":{"type":"integer"},"status":{"type":"string","enum":["current","archived","all"],"description":"Filter by status: current, archived, or all. Defaults to current."}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"5b9319d61bc4342a49b2908090751af04b3bfe6cf343d6e89fb6cfe2912c24a1","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T23:46:56.684Z","metadataTrust":"untrusted"},{"serverName":"com.shotpulled/shotpulled","endpointFingerprint":"4f7536feb2c5f3000c36b0b7f69c27d8c420518af9845f19cbb05fd50af49232","name":"list_scales","title":"List scales","description":"List registered scales for the account. The `id` on each row is the number this account knows that record by, counting from 1: safe to show, and what other tools expect back.","inputSchema":{"type":"object","properties":{"status":{"type":"string","enum":["current","archived","all"],"description":"Filter by status: current (unarchived), archived, or all. Defaults to current."}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"4aca98fa0ab4b2d66e595362cb06359ea560084dda3f173071d20401c1f2e55b","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T23:46:56.684Z","metadataTrust":"untrusted"},{"serverName":"com.shotpulled/shotpulled","endpointFingerprint":"4f7536feb2c5f3000c36b0b7f69c27d8c420518af9845f19cbb05fd50af49232","name":"list_shots","title":"List shots","description":"List shot history with support for pagination and filtering. Every shot carries a derived taste_pending flag (1 = logged with no sensory tags, no rating, and no tasted flip: the tasting is still owed and can be backfilled with update_shot).","inputSchema":{"type":"object","properties":{"filters":{"type":"object","properties":{"bean_id":{"type":"integer","description":"Filter by coffee bean ID"},"bag_id":{"type":"integer","description":"Filter by bag number (one purchase of a coffee)"},"grinder_id":{"type":"integer","description":"Filter by grinder ID"},"machine_id":{"type":"integer","description":"Filter by machine ID"},"favourite":{"type":"integer","enum":[0,1],"description":"Filter by favourite status"},"best":{"type":"integer","enum":[0,1],"description":"Filter by best brew status"},"date_from":{"type":"string","description":"Filter shots pulled on or after YYYY-MM-DD"},"date_to":{"type":"string","description":"Filter shots pulled on or before YYYY-MM-DD"},"taste_pending":{"type":"integer","enum":[0,1],"description":"1 = shots logged without sensory tags, a rating, or the tasted flip (tasting still owed); 0 = tasted shots"}}},"limit":{"type":"integer","default":50,"minimum":1,"maximum":500,"description":"Number of records to return (1-500)"},"offset":{"type":"integer","default":0,"minimum":0,"description":"Offset for pagination"}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"0e8479738ffa6d31663f73fd51347c492259e720fec190fc09103ed3b14f06a4","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T23:46:56.684Z","metadataTrust":"untrusted"},{"serverName":"com.shotpulled/shotpulled","endpointFingerprint":"4f7536feb2c5f3000c36b0b7f69c27d8c420518af9845f19cbb05fd50af49232","name":"list_waters","title":"List water recipes","description":"List registered waters for the account. The `id` on each row is the number this account knows that record by, counting from 1: safe to show, and what other tools expect back.","inputSchema":{"type":"object","properties":{"status":{"type":"string","enum":["current","archived","all"],"description":"Filter by status: current (unarchived), archived, or all. Defaults to current."}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"32ea54b18a0f9a7413e8b626eacddf45324138d9d44ae26682d09df97aaf0bc3","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T23:46:56.684Z","metadataTrust":"untrusted"},{"serverName":"com.shotpulled/shotpulled","endpointFingerprint":"4f7536feb2c5f3000c36b0b7f69c27d8c420518af9845f19cbb05fd50af49232","name":"lock_recipe","title":"Lock a recipe","description":"Lock a successful shot as the reference dialing recipe for this equipment profile. It overwrites the recipe already locked for the same coffee, grinder, machine, program and drink intent, which keeps its recipe_id.","inputSchema":{"type":"object","properties":{"from_shot_id":{"type":"integer"},"drink_intent":{"type":"string","enum":["straight","milk"]}},"required":["from_shot_id","drink_intent"]},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false},"definitionHash":"02a77bcac343874aa5f83961a0926eccc48972b498594e8a0fb702a24c23754a","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T23:46:56.684Z","metadataTrust":"untrusted"},{"serverName":"com.shotpulled/shotpulled","endpointFingerprint":"4f7536feb2c5f3000c36b0b7f69c27d8c420518af9845f19cbb05fd50af49232","name":"log_maintenance","title":"Log maintenance","description":"Log a cleaning or maintenance job against a piece of equipment. A task that takes the thing apart opens a calibration epoch, and every recipe locked before it is read through that epoch's offset. Record the offset here if you counted the clicks while reassembling, which is the one moment anybody actually knows it. Any task in the maintenance vocabulary can be logged against a grinder or machine it belongs to, including one the maker advises against, because the log records what was done. Read each piece of equipment's tasks, their intervals and their due state from list_grinders and list_machines.","inputSchema":{"type":"object","properties":{"equipment_kind":{"type":"string","enum":["grinder","machine"],"description":"Which kind of equipment this job was done on"},"equipment_id":{"type":"integer","description":"The ID of that piece of equipment"},"task":{"type":"string","enum":["burr_clean","backflush_water","backflush_detergent","descale","group_gasket_replace","shower_screen_clean","shower_screen_replace","group_head_wipe","basket_portafilter_soak","steam_wand_purge","steam_wand_soak","drip_tray_clean","water_tank_clean","water_filter_replace","boiler_water_change","lever_piston_seal_replace","lever_lubricate","milk_system_clean","professional_service","builtin_grinder_burr_clean","builtin_grinder_burr_replace","grinder_quick_clean","grinder_cleaning_tablets","burr_replace","hopper_clean","grounds_cup_clean","bearing_lubricate","gasket_seal_replace","idle_rinse","water_wash","dishwasher","filter_prime","softener_regenerate","other"],"description":"Which maintenance job was performed"},"performed_at":{"type":"string","description":"When it was done (ISO 8601 or YYYY-MM-DD HH:MM:SS, UTC). Defaults to now; backdating is fine"},"note":{"type":"string","description":"Optional: what you did, and anything that surprised you"},"disturbs_zero":{"type":"integer","enum":[0,1],"description":"Whether this job disturbed the reference the stored numbers are read against: for a burr clean, whether the burrs actually came out. Defaults to the task's own answer; send 0 for a wipe-down that left the collar alone"},"offset_value":{"type":"number","description":"The correction, if you measured it now: clicks to ADD to a pre-clean reading to get the same grind today, signed along the collar's own number direction. Omit it and the epoch stays unmeasured, which is a state the app shows rather than a zero it assumes"},"offset_source":{"type":"string","enum":["pull","counted","typed"],"description":"How the offset was arrived at: pull (a reference shot), counted (clicks counted at reassembly), typed (asserted directly)"},"evidence":{"type":"string","description":"One line recording what the measurement rested on, e.g. \"Counted 6 clicks coarser at reassembly.\""},"details":{"type":"object","additionalProperties":true,"description":"Fields specific to this task. Which ones a task takes is published as details_fields on each task; a burr clean takes none"},"guide_id":{"type":"string","description":"Optional: the id of the maintenance guide that was followed. Must be a guide for this task"}},"required":["equipment_kind","equipment_id","task"]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"definitionHash":"09a507e42ac7897c2d3def419797f0226d84b00f3570775a17b3b0c892c2a7ea","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T23:46:56.684Z","metadataTrust":"untrusted"},{"serverName":"com.shotpulled/shotpulled","endpointFingerprint":"4f7536feb2c5f3000c36b0b7f69c27d8c420518af9845f19cbb05fd50af49232","name":"log_recommendation","title":"Log a recommendation","description":"Log a recommended dialing change to allow contradiction/oscillation checking (G2).","inputSchema":{"type":"object","properties":{"lever":{"type":"string","enum":["grind","yield","temp","program","prep","none"]},"direction":{"type":"string","enum":["finer","coarser","more","less","same"]},"rationale":{"type":"string"},"confidence":{"type":"string","enum":["low","medium","high"]},"cited_rules":{"type":"array","items":{"type":"string"}},"based_on_shot":{"type":"integer"}},"required":["lever","direction","rationale","confidence"]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"definitionHash":"6d6d2138ba6158308d580fd51214186541dd9d91f5ab3e7a851ce1d149d1b73e","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T23:46:56.684Z","metadataTrust":"untrusted"},{"serverName":"com.shotpulled/shotpulled","endpointFingerprint":"4f7536feb2c5f3000c36b0b7f69c27d8c420518af9845f19cbb05fd50af49232","name":"log_shot","title":"Log a shot","description":"Log an espresso or alternative shot/brew attempt. Uses the active context (bean/grinder/machine/program) unless overridden via bean_id/grinder_id/machine_id/program_id. ALWAYS pass bean_id explicitly when the user names a specific coffee, so the shot cannot land on the wrong bag. Backdate with pulled_at when the shot happened earlier. When the user reports taste (bitter, sour, harsh, hollow…), include matching sensory_tags: the diagnosis engine reads tags and metrics, not free-text flavor_notes. When the user tasted the shot and reports it as GOOD/clean (no defects), pass tasted=1 with no sensory_tags. Otherwise a tag-less, rating-less shot is filed taste-pending as if never tasted.","inputSchema":{"type":"object","properties":{"dose_g":{"type":"number"},"yield_g":{"type":"number"},"time_s":{"type":"number"},"bean_id":{"type":["integer","null"],"description":"Override: log against this bean instead of the active one (null = active)"},"bag_id":{"type":["integer","null"],"description":"Which bag of the coffee the shot came from; defaults to its current (open) bag. Bag numbers are on list_beans' bags[]"},"grinder_id":{"type":["integer","null"],"description":"Override: grinder used, if not the active one (null = active)"},"machine_id":{"type":["integer","null"],"description":"Override: machine used, if not the active one (null = active)"},"program_id":{"type":["integer","null"],"description":"Override: machine program used, if not the active one (null = active)"},"pulled_at":{"type":["string","null"],"description":"When the shot was actually pulled (ISO 8601 or \"YYYY-MM-DD HH:MM:SS\"), for backdated entries. Defaults to now (null = now). When backdating, pass the returned shot_id to diagnose_shot explicitly, because the default diagnosis target is the chronologically latest shot."},"finish_action":{"type":"string","enum":["hard_stop","passive_drip"]},"drink_intent":{"type":"string","enum":["straight","milk"]},"flavor_notes":{"type":"string","maxLength":4096},"sensory_tags":{"type":"array","maxItems":64,"items":{"type":"string","maxLength":128}},"observations":{"type":"object","maxProperties":64},"temp_taste":{"type":"string","enum":["hot","warm","cold"]},"rating":{"type":"integer","minimum":1,"maximum":5},"verdict":{"type":"string"},"data_confidence":{"type":"string","enum":["measured","recalled","estimated"],"description":"measured = weighed/timed live; recalled = from memory; estimated = a best guess (e.g. \"~25s\" after missing the timer)"},"temperature_c":{"type":"number","description":"Brew temperature in Celsius"},"bloom_time_s":{"type":"number","description":"Pre-wetting or bloom duration in seconds"},"first_drip_time_s":{"type":"number","description":"Time to first drip in seconds"},"pressure_profile":{"type":"string","maxLength":16384,"description":"Pressure profile description or values"},"beverage_g":{"type":"number","description":"Yield mass excluding cup/vessel weight in grams"},"tds":{"type":"number","description":"Total Dissolved Solids percentage (e.g. 9.1 or 1.35)"},"water_id":{"type":"integer","description":"Optional references to waters formulation"},"vessel_name":{"type":"string","description":"Cup/vessel name"},"vessel_weight_g":{"type":"number","description":"Cup/vessel weight in grams"},"favourite":{"type":"integer","enum":[0,1],"description":"1 if favourite, 0 otherwise"},"best_brew":{"type":"integer","enum":[0,1],"description":"1 if marked as best brew, 0 otherwise"},"tasted":{"type":"integer","enum":[0,1],"description":"1 = the shot was tasted at log time. The explicit way to record a CLEAN tasting: sensory tags all describe defects, so a good shot has none. Without this flag (or a rating) it would be filed taste-pending. Tags or a rating also mark a shot as tasted; 0 (default) = taste later."},"flow_profile":{"type":"string","maxLength":16384,"description":"Opaque flow profile data (JSON/TEXT)"},"method_tools":{"type":"string","maxLength":4096,"description":"JSON representation of method tools used (e.g., paper filters, screen)"},"machine_settings":{"type":"object","maxProperties":16,"description":"Only when this one shot was pulled with a selector somewhere other than the machine's recorded settings: {key: position}. The shot is otherwise stamped with those automatically; a lasting change goes through update_machine."}},"required":["dose_g","yield_g","time_s","finish_action"]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"definitionHash":"7dea22642a7c07ec1b82fd8ba7c3ae48d75e810c7e29dba1e0d4eb4844598463","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T23:46:56.684Z","metadataTrust":"untrusted"},{"serverName":"com.shotpulled/shotpulled","endpointFingerprint":"4f7536feb2c5f3000c36b0b7f69c27d8c420518af9845f19cbb05fd50af49232","name":"merge_beans","title":"Merge two coffees","description":"Fold one coffee into another when the same coffee was registered twice. Every bag, shot, recipe and recommendation of from_bean_id moves to into_bean_id; the active coffee follows if it was the one merged away; origins move only if the target has none. Where both hold a locked recipe for the same grinder, machine, program and drink, the newer lock wins and the older is deleted. The source coffee is archived, never deleted. Irreversible: confirm both numbers with the user first (list_beans shows them).","inputSchema":{"type":"object","properties":{"from_bean_id":{"type":"integer","description":"The duplicate: the coffee number that will be emptied and archived"},"into_bean_id":{"type":"integer","description":"The coffee number that keeps everything"},"reason":{"type":"string","description":"Optional note, recorded on the surviving coffee's notes with the merge"}},"required":["from_bean_id","into_bean_id"]},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":false},"definitionHash":"cc218e6be20c91ca318caf4cdf5a3c5d4c9b7a27163fc627ec62345f8829d453","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T23:46:56.684Z","metadataTrust":"untrusted"},{"serverName":"com.shotpulled/shotpulled","endpointFingerprint":"4f7536feb2c5f3000c36b0b7f69c27d8c420518af9845f19cbb05fd50af49232","name":"register_bag","title":"Register a bag","description":"Register another bag of a coffee that is already in list_beans: the same roaster's product, bought again. It keeps the coffee's recipes, notes and history; only the purchase facts (roast date, weight, price, state) are new. Does not change the active coffee. Returns a bag_id: bag numbers are their own series, separate from bean numbers. For a coffee that is not in list_beans yet, call register_coffee instead.","inputSchema":{"type":"object","properties":{"bean_id":{"type":"integer","description":"This account's own coffee number, from list_beans. Never guess one."},"roast_date":{"type":"string","description":"Calendar day in YYYY-MM-DD format: a day, not a timestamp"},"bag_weight_g":{"type":"number","description":"Bag weight in grams"},"cost":{"type":"number"},"currency":{"type":"string"},"buy_date":{"type":"string","description":"Calendar day in YYYY-MM-DD format: a day, not a timestamp"},"state":{"type":"string","enum":["sealed","open","frozen","finished"],"description":"Defaults to sealed; the first log_shot against it opens it"},"opened_date":{"type":"string","description":"Calendar day in YYYY-MM-DD format: a day, not a timestamp"},"storage":{"type":"string"},"best_by_date":{"type":"string","description":"Calendar day in YYYY-MM-DD format: a day, not a timestamp"},"bag_notes":{"type":"string","maxLength":4096,"description":"Notes about THIS bag (a batch note, where it was bought). The coffee's own description lives on the coffee, in notes."},"ean":{"type":"string"},"qr_code":{"type":"string"},"catalog_coffee_id":{"type":"string","description":"Set by the apps. Leave out."},"product_id":{"type":"string","description":"Set by the apps. Leave out."},"lot_revision_id":{"type":"string","description":"Set by the apps. Leave out."}},"required":["bean_id","roast_date"]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"definitionHash":"37c0b065df9b9f8a888fc22ebc63d13eff9c2daf4e522cc0ad9d82dfe05344f7","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T23:46:56.684Z","metadataTrust":"untrusted"}],"endpoints":[{"endpointFingerprint":"4f7536feb2c5f3000c36b0b7f69c27d8c420518af9845f19cbb05fd50af49232","protocol":"streamable-http","status":"indexed","toolCount":44,"observedAt":"2026-11-16T23:46:56.684Z"}],"authentication":"unknown"},"connectionConfigurations":{"status":"ready","authentication":"not embedded","clients":{"Claude Desktop":{"mcpServers":{"com.shotpulled/shotpulled":{"url":"https://mcp.shotpulled.com/mcp"}}},"Cursor":{"mcpServers":{"com.shotpulled/shotpulled":{"url":"https://mcp.shotpulled.com/mcp"}}},"VS Code":{"servers":{"com.shotpulled/shotpulled":{"type":"http","url":"https://mcp.shotpulled.com/mcp"}}}}},"resourceType":"mcp-server","callable":true,"runtime":{"callable":true,"protocols":["mcp"]},"interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://mcp.shotpulled.com/mcp"}],"profile":{"apiVersion":"1","schemaVersion":"1","id":"mcp-server:com.shotpulled%2Fshotpulled","resourceType":"mcp-server","canonicalUrl":"https://www.agentsjunction.com/api/v1/servers/com.shotpulled%2Fshotpulled","name":"com.shotpulled/shotpulled","description":"Espresso dialing: log a shot, say how it tasted, get one change in your grinder's own clicks.","interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://mcp.shotpulled.com/mcp"}],"capabilities":[],"identity":{"source":"official-registry","websiteUrl":"https://shotpulled.com","repositoryUrl":null,"version":"1.4.2"},"verification":{"state":"official","confidence":100},"operations":{"resourceType":"mcp-server","name":"com.shotpulled/shotpulled","status":"online","lastCheckedAt":"2026-11-20T07:18:02.050Z","lastSuccessfulCheck":"2026-11-20T07:18:02.050Z","latencyMs":41,"consecutiveFailures":0,"isStale":false,"checks":{"endpointReachable":true,"protocolValid":true,"agentCardValid":null,"mcpHandshakeValid":true},"lastSeen":null,"lastSuccessfulInteraction":null,"lastHealthCheck":"2026-11-20T07:18:02.050Z","source":{"type":"health-check","url":null},"observedAt":"2026-11-20T07:18:02.050Z"},"security":null,"timestamps":{"createdAt":"2026-10-26T11:42:43.407Z","updatedAt":"2026-10-26T11:42:43.407Z","observedAt":"2026-11-20T07:18:02.050Z"},"compatibility":{"serverVersion":"1.4.2","protocolVersions":[{"protocol":"mcp","version":null}]}}}}