CosmicSelf API Documentation

Structured cosmic identity profiles for AI agent personalization. Base URL: https://cosmicself.ai/api/v1

Quickstart

Get your first cosmic identity profile in 5 minutes. Claim a Founder key and make your first API call.

API Reference

Full endpoint documentation with curl examples, request/response schemas, and error handling.

For AI Agents

System prompt snippets, integration patterns, and best practices for AI agent personalization.

Get API Access

Claim a free Founder key or apply for a paid tier. First 100 AI platforms get permanent free access.

What is the CosmicSelf API?

CosmicSelf API gives AI platforms a cosmic identity layer — six ancient systems synthesized into a single machine-readable profile. One API call returns structured personality traits your AI agent can use to personalize every interaction, from session one.

Six systems, one profile

  • 1.Western Astrology — Sun, Moon, Rising, planetary positions, aspects
  • 2.Vedic Astrology — Sidereal chart, Moon nakshatra, dashas
  • 3.Human Design — Type, authority, profile, defined centers, strategy
  • 4.64 Archetypes — Key gates, channels, and archetype patterns
  • 5.Cardology — Birth card, planetary ruling card
  • 6.Numerology — Life path, expression number, soul urge

How does the API work?

Authentication

All requests require a Bearer token in the Authorization header:

Authorization: Bearer cs_founder_your_key_here

Response format

Every response includes a next_steps[] array with plain-English suggestions for what to do next. Error responses include recoverable and requires_human flags so your agent can decide how to handle failures autonomously.

Billing

Only POST /profile/generate costs credits. All read requests (GET) are unlimited and free. Profiles are cached permanently after first generation.

MCP Server (Coming Soon)

CosmicSelf MCP Server will allow Claude, Cursor, and MCP-compatible agents to query profiles directly via the Model Context Protocol. No REST calls needed — your agent will have native access to cosmic identity data.