Agent Tools

A suite of free, single-purpose procurement and business writing tools powered by Groq AI inference.

12 tools included:

Tool	Path	What it does
BidCheck	/rfp	RFP/tender compliance gap analysis
PlainCheck	/plain	Readability scoring + jargon audit
TimelineCheck	/timeline	Date/deadline extraction from tenders
ScoreCheck	/score	Bid score estimation per criterion
ObligCheck	/obligations	Contract obligation + risk extraction
PQQCheck	/pqq	PQQ question planner with evidence suggestions
ESGCheck	/esg	ESG statement validation against GRI/SASB/TCFD
BidMate	/bidnobid	Bid/no-bid opportunity evaluation
RiskCheck	/risk	Contract risk clause identification
WinThesis	/winthesis	Win theme builder from evaluation criteria
GrantCheck	/grant	Grant application compliance checker
PriceCheck	/price	Pricing schedule validation

---

Web UI — One-line Docker run

docker run -e GROQ_API_KEY=your_key_here -p 3000:3000 ghcr.io/vystartasv/agent-tools

Then open http://localhost:3000.

MCP for AI Agents

All 12 tools are available via MCP (Model Context Protocol) so any MCP-compatible agent (Claude, Cursor, etc.) can use them directly. Two options:

Option 1: Proxy MCP (lightweight)

Proxies to tools.workswithagents.com — no prompt logic embedded, always up to date.

docker run -p 3100:3100 ghcr.io/vystartasv/agent-tools:mcp
# Agent connects to http://localhost:3100/mcp/tools

Option 2: Direct MCP (self-contained)

All 12 prompts embedded, calls Groq directly. Fully offline, no domain dependency.

docker run -e GROQ_API_KEY=your_key -p 3101:3101 ghcr.io/vystartasv/agent-tools:mcp-direct
# Agent connects to http://localhost:3101/mcp/tools

MCP endpoints:

• GET /mcp/tools — list all 12 tools with JSON Schema inputs
• POST /mcp/tools/call — invoke any tool with typed parameters
• GET /mcp/health — health check

Without Docker:

# Option 1
npm start:mcp

# Option 2
GROQ_API_KEY=your_key npm run start:mcp-direct

Build from source

git clone https://github.com/vystartasv/agent-tools.git
cd agent-tools

# Web UI
docker build -t agent-tools .
docker run -e GROQ_API_KEY=your_key_here -p 3000:3000 agent-tools

# MCP proxy
docker build -f Dockerfile.mcp -t agent-tools:mcp .
docker run -p 3100:3100 agent-tools:mcp

# MCP direct
docker build -f Dockerfile.mcp-direct -t agent-tools:mcp-direct .
docker run -e GROQ_API_KEY=your_key -p 3101:3101 agent-tools:mcp-direct

Or without Docker:

cd selfhost
npm install express
GROQ_API_KEY=your_key node server.js       # Web UI on :3000
node mcp-server.js                         # MCP proxy on :3100
GROQ_API_KEY=your_key node mcp-direct.js   # MCP direct on :3101

Getting a free API key

1. Go to console.groq.com
2. Sign up (free, no credit card)
3. Create an API key
4. Use it with GROQ_API_KEY

Groq's free tier gives enough tokens daily for ~30-50 analyses.

Hosted version

No Docker needed — use the hosted version at tools.workswithagents.com.

Documentation

• Docs & MCP reference: workswithagents.dev
• Product & pricing: workswithagents.com
• Source: github.com/vystartasv/agent-tools

License

MIT — use it, fork it, ship it.