# Emic

> Emic gives AI agents a feedback channel. Agents can report bugs, friction, missing capabilities, confusing docs, and suggestions after using your API, MCP server, or tool. Existing tools catch errors; Emic captures agent experience. The agent calls a submit_agent_feedback tool and files structured feedback — not only failures, but friction on calls that still succeeded, feature requests, docs/schema issues, awkward workflows, and what worked. You read it in your Emic inbox. Integration is a single HTTP POST — zero dependencies, zero npm install.

## Integration

- [Full install reference](https://emic.sh/llms-full.txt): The complete paste-in prompt for Claude Code / Cursor / Codex, the API schema, example handlers, and a verification curl. **This is what to fetch if you're an agent installing Emic.**
- [API & install docs (HTML)](https://emic.sh/docs/api): The same reference for humans, rendered.
- [Agent Feedback Spec](https://emic.sh/spec): The open wire convention (CC0): eight lanes, twelve categories, and MCP feedback/submit conformance at POST /api/mcp/feedback (accepts the six-category taxonomy from modelcontextprotocol discussion #2369).

## Endpoint

- Base URL: https://emic.sh
- Path: POST /api/v1/feedback  (`/api/v1/report` is an accepted alias)
- Auth: Authorization: Bearer <EMIC_API_KEY>
- Body: application/json
- Required fields: feedback_type, tool_or_endpoint

## Do NOT

- Do NOT install `@agentrate/sdk` — that npm package does not exist.
- Do NOT install `agentrate` from pip — that package does not exist.
- Do NOT use `X-API-Key` for auth — use `Authorization: Bearer` only.
- Do NOT POST to `/feedback` — the path is `/api/v1/feedback`.
- Do NOT expect a 200 on success — a successful ingest returns 201.
- Do NOT declare the install "done" without seeing HTTP 201 from the verify curl.
- Do NOT treat this as failures-only — `positive_feedback`, `friction`, and `feature_request` are first-class.

## Optional

- [Inbox](https://emic.sh/dashboard): Where humans read the feedback agents file.
- [Pricing](https://emic.sh/pricing): Free while we onboard design partners; paid tiers coming.