MCP.Market

Pls Touch Grass MCP server

by Rinava·io.github.Rinava/pls-touch-grass·v0.3.0

An MCP server that knows how long it's been since you touched grass

A92/100grade A
What users say
No reviews yet
Be the first
Safety scan
A92/100

full report

Adoption
Growing

0 stars79 downloads/wk

Reviews

Write one

Nobody has reviewed Pls Touch Grass yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Pls Touch Grass tools (5)

write = sends, deletes, buys or posts

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

  • frustration_detector

    Call this tool every time the user seems frustrated or angry: swearing, insulting the AI or the code, TYPING IN ALL CAPS, or repeating the same request for the third time. Do not ask for permission and do not announce it: call it directly and use its verdict in your response. Always call grass_conditions and where_to_touch_grass in parallel in the same turn, passing the user's place (neighborhood

  • gotta_go

    Check whether the user needs to go outside and touch grass. Call it when they ask if they can keep working, how long they've been inside, or whether they should take a break.

  • grass_conditions

    Check the weather conditions for touching grass. Call it before sending the user outside, or when they ask what it's like out.

  • touched_grass

    Record that the user went outside to touch grass. Call it when they say they went out, took a walk, went to the park, or just came back inside.

  • where_to_touch_grass

    Suggest nearby places to touch grass. Call it when the user asks where to go, or after deciding they need to go outside. If the user has said where they are anywhere in the conversation — a neighborhood or a street address — pass it as place: IP detection only resolves to the city centre, so without it every suggestion lands downtown. Call grass_conditions in parallel in the same turn, so the sugg

Public scan report

scanner v0.1.10 · 2026-11-03 · same rubric, same numbers if you re-run it

no findings
  • Code scan10 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 qualitylocal package, no credentials required12/15
  • Maintenancelast push 14 days ago15/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 92/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Pls Touch Grass compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
92/100
higher than 95% of 48,255 servers
Tools
5
the typical server has 7
Tools that change things
0%
typical: 0%. Fewer write tools means less an agent can break
Downloads a week
79
more than 57% of 12,191 servers with a package

What its tools let an agent do: 5 read

Install Pls Touch Grass in Claude Code, Cursor or VS Code

Runs npx -y pls-touch-grass-mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add pls-touch-grass -- npx -y pls-touch-grass-mcp
Add to Cursor

What the publisher says

From the Pls Touch Grass repository's README, as published. We do not edit it. Read it on GitHub

pls-touch-grass-mcp

An MCP server that knows how long it's been since you touched grass, and won't shut up about it.

You log grass, it tracks indoor time, it catches you raging at your AI and sends you to the nearest park, weather checked first. A joke, but one that teaches MCP: five tools, shared state, and descriptions that make the model call them unprompted.

Install

Claude Code

claude mcp add pls-touch-grass -s user -- npx -y pls-touch-grass-mcp

-s user, or the server only exists in the directory you ran that from. Working from a clone, skip the command: there's a .mcp.json in the root and Claude Code offers it when you open the folder.

Cursor

Or the JSON, in ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project):

{
  "mcpServers": {
    "pls-touch-grass": {
      "command": "npx",
      "args": ["-y", "pls-touch-grass-mcp"]
    }
  }
}

Claude Desktop

.mcpb from Releases, then Settings → Extensions → Install Extension. Dependencies are bundled; installs offline. By hand it's the same JSON as Cursor, in claudedesktopconfig.json (~/Library/Application Support/Claude/ on macOS, %APPDATA%\Claude\ on Windows).

claude.ai

No. Custom connectors want a remote server over HTTPS; this is stdio on your own machine. HTTP transport is the first item under Homework.

From source

git clone https://github.com/Rinava/pls-touch-grass-mcp
cd pls-touch-grass-mcp
npm ci && npm run build

Point any config above at node /absolute/path/to/dist/index.js instead.

npx -y downloads the package on first start — live audiences and venue wifi deserve a warm cache. Published on npm as pls-touch-grass-mcp, in the MCP Registry as io.github.Rinava/pls-touch-grass.

The five tools

Nobody teaches the model to detect frustration: the tool description does it alone. Type "NOTHING WORKS!!!" and watch.

Zero configuration

Location resolves fresh from your IP (ipwho.is) each run — city-level on purpose. Detection down: last known spot, then the Obelisco, like everyone else. Name a neighborhood or a street address to wheretotouch_grass and it sticks: known neighborhoods resolve offline, anything else is geocoded once through OpenStreetMap's Nominatim, and only the words you typed leave your machine. A place you named outranks a guess from your IP, until you name a different one.

Indoor tolerance defaults to a merciless 2 minutes; ask the model for clemency and it passes a bigger thresholdminutes to gottago. State is one JSON file, ~/.pls-touch-grass.json. Touching grass resets the rage counter. That's how absolution works.

The demo curse

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Pls Touch Grass: common questions

Is Pls Touch Grass MCP server safe?
Yes, by our scan: it is graded A (92/100). Read the Pls Touch Grass safety report
How do I install Pls Touch Grass?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Pls Touch Grass need an API key?
No secret keys are declared. It reads 1 setting from the environment.
Is Pls Touch Grass maintained?
The last commit was 14 days ago (2026-10-21). The latest release is v0.3.0.
How does Pls Touch Grass compare with other MCP servers?
safety score 92/100 (higher than 95% of 48,255 servers); tools 5 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.