# freelance-ops-mcp [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/nimish14/practical-llm-apps  
**GitHub Stars:** 0  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/freelance-ops-mcp

## Description
Freelance invoice ops MCP — overdue status, tone suggestion, and reminder drafts

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "freelance-ops-mcp": {
    "command": "npx",
    "args": ["-y","@modelcontextprotocol/inspector"]
  }
}
```

## Documentation & README

# Practical LLM Apps

**Clone-and-run AI agents, RAG apps, and MCP servers.**

Hand-built examples you can customize and ship — not slide-deck demos.

Works with OpenAI, and several apps run fully local with no API key.

---

## Run one now

### Invoice Follow-up Agent

```bash
git clone https://github.com/nimish14/practical-llm-apps.git
cd practical-llm-apps/starter_ai_agents/invoice_followup_agent
pip install -r requirements.txt
cp .env.example .env   # add OPENAI_API_KEY
streamlit run app.py
```

### Chat with PDF

```bash
cd practical-llm-apps/starter_ai_agents/chat_with_pdf
pip install -r requirements.txt
cp .env.example .env   # add OPENAI_API_KEY
streamlit run app.py
```

### Resume Evidence RAG (no API key)

```bash
cd practical-llm-apps/rag_apps/resume_evidence_rag
pip install -r requirements.txt
streamlit run app.py
```

### Freelance Ops MCP (Cursor / Claude)

```bash
cd practical-llm-apps/mcp_servers/freelance-ops-mcp
npm install
npm run build
npx -y @modelcontextprotocol/inspector node dist/index.js
```

Add to Cursor MCP settings:

```json
{
  "mcpServers": {
    "freelance-ops": {
      "command": "npx",
      "args": ["-y", "freelance-ops-mcp"]
    }
  }
}
```

*(After `npm publish` — until then, point `args` at `node` + local `dist/index.js`.)*

---

## Browse templates

### Starter AI Agents

| App | Description |
|-----|-------------|
| [Invoice Follow-up Agent](https://github.com/nimish14/practical-llm-apps/blob/HEAD/starter_ai_agents/invoice_followup_agent/) | Draft polite → firm invoice reminders with tone control and overdue context |
| [Chat with PDF](https://github.com/nimish14/practical-llm-apps/blob/HEAD/starter_ai_agents/chat_with_pdf/) | Ask questions about an uploaded PDF with page citations |

### RAG Apps

| App | Description |
|-----|-------------|
| [Resume Evidence RAG](https://github.com/nimish14/practical-llm-apps/blob/HEAD/rag_apps/resume_evidence_rag/) | Hybrid MiniLM + BM25 retrieval that returns grounded resume facts for a job description |

### MCP Servers

| Server | Description |
|--------|-------------|
| [freelance-ops-mcp](https://github.com/nimish14/practical-llm-apps/blob/HEAD/mcp_servers/freelance-ops-mcp/) | Tools for overdue status, tone suggestion, and invoice reminder drafts |
| [resume-evidence-mcp](https://github.com/nimish14/practical-llm-apps/blob/HEAD/mcp_servers/resume-evidence-mcp/) | BM25 resume evidence retrieval tools for coding agents |

---

## Project goals

1. Every app: **clone → install → run** in under 2 minutes
2. Clear README with problem, pipeline, and limits
3. MCP servers packaged for npm + MCP Registry
4. Prefer small, focused tools over mega-frameworks

---

## License

MIT — fork it, ship it, sell it.