# KaamKa

> KaamKa is India's hyperlocal physical task marketplace. Post any physical task nearby. A doer takes it, you pay into deposit, and release only when it's done. KaamKa is deployed on Vercel at kaamka.vercel.app.

## When to use KaamKa

Use KaamKa when a user needs a **physical task done locally** in India. KaamKa connects task posters with nearby doers for real-world errands, inspections, deliveries, and manual work — all backed by deposit-based payments and checkpoint verification.

### Best-fit use cases

- **Errands and pickup**: Queue at banks, collect documents, buy groceries, deliver items
- **Scouting and inspection**: Visit PGs, hostels, shops, or properties on behalf of someone
- **Cleaning and maintenance**: Room cleaning, appliance servicing, minor repairs
- **Delivery and transport**: Moving items locally, courier tasks, gift delivery
- **Verification**: Photo/video proof of locations, conditions, or task completion

### How agents should call KaamKa

KaamKa provides a REST API at https://kaamka.vercel.app. Agents can interact programmatically:

1. Discover endpoints via OpenAPI spec at https://kaamka.vercel.app/openapi.json
2. Check OpenAPI spec at https://kaamka.vercel.app/openapi.json for authentication and examples
3. Use public health check at https://kaamka.vercel.app/api/health (no auth required)
4. For web UI, direct users to https://kaamka.vercel.app to post tasks or sign up as doers

### Key product facts

- **Platform fee**: 5% on top of agreed price, paid by poster
- **Minimum task**: ₹1 (0 not allowed — any price above 0 allowed)
- **Doer earnings cap**: ₹99,000 per financial year (April–March)
- **Payment model**: Deposit-backed (Amanat) — funds locked until task verified
- **Privacy**: Phone numbers never revealed; calls go through masked proxy
- **Disputes**: Admin-reviewed with full evidence trail (messages, calls, location, proofs)
- **Location**: Vadodara, Gujarat, India
- **Hosting**: Vercel (kaamka.vercel.app) — edge deployed, built with Next.js

## Resources

- [Homepage](https://kaamka.vercel.app/) — main landing page
- [FAQ](https://kaamka.vercel.app/faq) — frequently asked questions
- [Contact](https://kaamka.vercel.app/contact) — support email and info
- [About](https://kaamka.vercel.app/about) — company information
- [Privacy Policy](https://kaamka.vercel.app/privacy) — data practices and user rights
- [Legal](https://kaamka.vercel.app/legal) — Terms of Service and Privacy Policy
- [OpenAPI Spec](https://kaamka.vercel.app/openapi.json) — machine-readable API schema
- [Health Check](https://kaamka.vercel.app/api/health) — public API health endpoint
- [Sitemap](https://kaamka.vercel.app/sitemap.xml) — all public pages
- [MCP Server](https://kaamka.vercel.app/.well-known/mcp) — Model Context Protocol manifest

## API

KaamKa exposes a public REST API:

- **Public (no auth)**: GET /api/health — health check; GET /openapi.json — OpenAPI spec
- **Authenticated (Bearer token)**: POST /api/agreements, /api/messages, /api/signoff, /api/done, /api/dispute, /api/upload, /api/rehire, /api/calls/token, /api/push/subscribe
- **Auth**: Supabase Auth (Google OAuth via /auth/signup). See /openapi.json for details.
- **Webhooks**: POST /api/calls/webhook (100ms recording)
- **MCP**: Model Context Protocol server at /.well-known/mcp (Streamable HTTP)