geez
by fitzyracing1
README.md
# geez
**Phone-first MCP tool that lets Claude (or any MCP client) call Grok.**
Minimal. Requests-only. Zero bloat. Built to run cleanly in Termux / proot-distro.
## Why "geez"
Because sometimes you just want Claude to be able to ask Grok without dragging the entire Super guard stack along.
## Quick start (phone or desktop)
```bash
pip install -e .
export XAI_API_KEY=your_xai_key_here # get one at https://console.x.ai
geez
```
Then connect any MCP client (Claude Desktop, Cursor, etc.) to the `geez` stdio server.
### From Claude
```
call_grok(
prompt="Explain quantum spin processors in plain English",
system="You are Grok, built by xAI. Be direct and helpful.",
model="grok-3",
max_tokens=800
)
```
## Tools exposed
| Tool | Description |
|-------------|--------------------------------------------------|
| `call_grok` | Send a prompt to Grok and get the response back |
## Environment
```bash
XAI_API_KEY=... # required
# GROK_API_KEY=... # alias also accepted
```
## Design principles
- Single dependency beyond stdlib: `requests` + `mcp`
- No guard pipelines, no Cisco, no Duo, no Stripe — just the call
- Phone-native: works in Termux with almost no setup
- Fully public and auditable
---
Made for the same phone-first workflow as the rest of the portfolio.
TDQS
C2.8/5.0
Scored across 1 tool
Disambiguation5/5
Only one tool exists, so no ambiguity between tools.
Naming Consistency5/5
Single tool follows a clear verb_noun pattern; no inconsistency.
Tool Count3/5
One tool is borderline thin for an API wrapper; typically 3-15 tools are expected.
Completeness2/5
The server lacks parameters like model selection or streaming, limiting its capability for complex interactions.
Maintenance
ActivitySlowing
ResponsivenessNo issues