API Reference

Complete documentation of the Akashic MCP REST API. All endpoints are available at https://akashic-mcp.com.

Table of Contents

• Introduction & Main Endpoints - Base URL, Authentication, Health Check, List Tools, Call Tool
• MCP Tools Endpoints - All available MCP tool endpoints
• File Management Endpoints - File upload, download, list, update, and delete
• OAuth 2.0 & Advanced - OAuth 2.0 endpoints, HTTP status codes, error handling, rate limiting

---

Quick Reference

Base URL

https://akashic-mcp.com

Authentication

Authentication is via token or OAuth only.

MCP and tool endpoints (e.g. /mcp, /tools/call): 1. Authorization Header: Authorization: Bearer <MCP_token_or_OAuth_access_token> 2. Query (deprecated): ?token=<token> for MCP token only; prefer the header.

Protected REST endpoints (e.g. /api/owner-ids/me, /api/user-preferences): 1. Authorization Header: Authorization: Bearer <token> 2. Cookie: auth_token cookie (set automatically after login) 3. Query Parameter: ?token=<token> where supported

---

Related Documentation

• Getting Started - Quick start guide
• Installation Guide - IDE setup instructions
• Authentication Guide - Detailed authentication information
• MCP Tools Reference - Complete MCP tools documentation