# Nichify for developers - API, MCP, Agents

> Developer hub for Nichify (https://nichify.app) - the Vinted niche
> finder. This page is scoped context for AI coding agents, integration
> partners, and human developers. See /api/llms.txt for the programmatic
> surface details and /agent-instructions.md for agent behaviour rules.

## Developer resources at a glance

- **MCP server**: https://nichify.app/mcp (Streamable HTTP, spec 2025-06-18)
- **MCP manifest**: https://nichify.app/mcp/manifest
- **MCP server card**: https://nichify.app/.well-known/mcp.json
- **OpenAPI 3.1 spec**: https://nichify.app/openapi.json
- **Agent instructions**: https://nichify.app/agent-instructions.md
- **PAT issuance**: https://nichify.app/account/keys
- **Product context**: https://nichify.app/llms.txt (short)
  and https://nichify.app/llms-full.txt (full)
- **Pricing / quotas**: https://nichify.app/pricing.md
- **Status page**: https://nichify.app/status and /api/status (JSON)
- **Contact**: contact@nichify.app / security@nichify.app

## What Nichify ships publicly

- Marketing site and subscription dashboard at https://nichify.app/.
- Catalog surface documented by the OpenAPI 3.1 spec at `/openapi.json`.
- First-party MCP server at `/mcp` exposing 17 tools across niche
  analyses, Vinted monitorings, closure events, and pipeline runs.
- Public read endpoints: `/llms.txt`, `/llms-full.txt`,
  `/agent-instructions.md`, `/pricing.md`, `/sitemap.xml`,
  `/feeds/*.jsonld`, `/.well-known/*`.

## Authentication model

- Dashboard users: email/password or Google OAuth. Session cookie
  `session_token` (SHA-256 hashed server-side, `Secure`, `HttpOnly`,
  `SameSite=Lax`).
- Agent callers: Personal Access Tokens with prefix `nch_`, created
  and revoked at https://nichify.app/account/keys. Send as
  `Authorization: Bearer nch_...` on MCP and REST requests.
- Scopes: `read` (list, get, export) and `write` (create analyses,
  create monitors). Every MCP tool declares its required scope in
  the manifest.

## Tech stack (high-level, public)

- Python 3.13 FastAPI backend, SQLAlchemy async ORM, Alembic
  migrations, PostgreSQL in production (SQLite for tests), Playwright
  for controlled scraping, Docker deploy.
- Frontend: plain HTML + vanilla JS, no SPA framework. Multi-language
  landings built by a Node.js script (FR primary, EN / DE / NL).
- MCP server: first-party Streamable HTTP implementation (JSON-RPC 2.0
  over POST), spec 2025-06-18, 17 tools registered via
  `nichify_app.mcp_server`.

## Integration path

1. **MCP-first** - connect to `https://nichify.app/mcp` with a PAT,
   call `tools/list` to discover the current tool set, then
   `tools/call` for reads and writes. Some tools annotate
   `_meta.ui.resourceUri` pointing at `ui://nichify/...` MCP Apps
   resources for rich rendering.
2. **REST fallback** - consume `/openapi.json` and generate a client
   in your language of choice. Every error is structured JSON
   (`application/problem+json`, RFC 7807).
3. **Context-only** - point your agent at `/llms.txt`,
   `/llms-full.txt`, and `/agent-instructions.md` to give it Nichify
   product context without calling any endpoint.

## Roadmap

- OAuth 2.0 authorization code + PKCE for delegated agent actions.
- Published verified integrations on ChatGPT connectors, Claude
  Desktop MCP directory, and the Gemini MCP registry. Tracking in
  https://nichify.app/integrations.html.
- Additional MCP tools for comparative analytics and alerts.

## Feedback channel

For integration feedback or partnership: contact@nichify.app