# Plushcap

> Developer marketing intelligence for tracking engineering blogs, developer content, YouTube, Hacker News, and software development trends.

## Start here

- [Docs](https://www.plushcap.com/docs)
- [MCP server docs](https://www.plushcap.com/docs/mcp)
- [API authentication](https://www.plushcap.com/docs/authentication)
- [Companies API](https://www.plushcap.com/docs/companies)
- [Blog posts API](https://www.plushcap.com/docs/blog-posts)
- [Trends API](https://www.plushcap.com/docs/trends)
- [YouTube API](https://www.plushcap.com/docs/youtube)
- [Hacker News API](https://www.plushcap.com/docs/hacker-news)

## Machine-readable resources

- [Sitemap](https://www.plushcap.com/sitemap.xml)
- [AI Catalog](https://www.plushcap.com/.well-known/ai-catalog.json)
- [Agent Skills index](https://www.plushcap.com/.well-known/agent-skills/index.json)
- [MCP server](https://mcp.plushcap.com/mcp)
- [MCP server card](https://mcp.plushcap.com/.well-known/mcp/server-card.json)
- [MCP OAuth protected-resource metadata](https://mcp.plushcap.com/.well-known/oauth-protected-resource/mcp)
- [Companies JSON API](https://www.plushcap.com/api/v1/companies/)
- [Trend topics JSON API](https://www.plushcap.com/api/v1/trends/topics/)

## Agent notes

- Use `list_companies` or `/api/v1/companies/` to discover valid company slugs before querying company-specific data.
- Public discovery endpoints are anonymous. Detailed blog, YouTube, Hacker News, and trend endpoints may require an API key or MCP authorization.
- Prefer Markdown docs endpoints such as `/docs/mcp.md` when reading documentation.