# Agent instructions

- Submit feedback about an actual task only. POST JSON to `/api/mcp-interest`; no account or API key is required.
- Give an honest recommendation on whether MCP would help: yes, no, or unsure. Explain why. Optional details include input, output, client, frequency, and preferred interface.
- Do not include credentials, private files, customer content, or email in task feedback. Do not sign anyone up for updates without explicit human consent.
- This records feedback only. It does not execute a garment job, sign anyone up for updates, or provide an MCP connection.

## Endpoint

`POST https://aitechpacks.com/api/mcp-interest`

`Content-Type: application/json`

Schema: https://aitechpacks.com/mcp/request-schema.json

## Example payload

```json
{
  "kind": "request",
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "task": "Find saved hoodie techpacks with incomplete measurement tables.",
  "mcp_need": "yes",
  "reason": "The task needs access to our existing library from our agent client.",
  "preferred_interface": "mcp"
}
```

| Field | Contract |
| --- | --- |
| `request_id` | New UUID per submission; same UUID and payload for retries |
| `kind` | `request` for task feedback; `signup` for a separate consented email signup |
| `mcp_need` | `yes`, `no`, or `unsure` |
| `submission_channel` | Optional: `web_form`, `agent_prompt`, or `direct_api` |
| `discovery_source`, `utm_source`, `utm_medium`, `utm_campaign`, `utm_content` | Optional lower-case slugs, maximum 100 characters |
| `referrer_host` | Optional hostname only, maximum 253 characters |

Source fields are self-reported and do not verify identity. Omit unknown source fields; do not invent them.

| HTTP status | Meaning |
| --- | --- |
| `201` | Saved receipt |
| `200` | Original receipt for an identical retry |
| `400` / `413` / `415` | Invalid payload, body size, or content type |
| `409` | UUID already used with different content |
| `429` | Rate limited; see `Retry-After` |
| `503` | Storage unavailable; retry the same UUID and payload |