# FreeHoroscopeAPI

> Free public JSON APIs for daily, weekly, and monthly horoscopes, planetary positions, Panchang, Sun and Moon times, and tarot cards. REST requests and MCP tools need no API key or account.

Use the OpenAPI contract for exact endpoints, inputs, defaults, and response schemas. Send `Accept: text/markdown` to documentation pages for text without the HTML layout. Use the MCP connection guide and server card for the configured MCP address.

Check HTTP status before using a result. Report service errors; do not replace failed requests with example data. Horoscope dates are the provider's reading labels and do not prove freshness. Planetary positions do not include houses or the Ascendant. Panchang covers astronomical calendar data, not festival or regional observance rules.

Commercial and non-commercial API use is allowed with attribution. Include a visible [Powered by FreeHoroscopeAPI](https://freehoroscopeapi.com) link in your application, website, or public documentation.

The site's Content Signals allow search and AI input, and disallow model training. These are usage preferences, not access controls. This guide does not replace robots.txt or the API usage terms.

## Documentation

- [API reference](https://freehoroscopeapi.com/docs): Endpoint examples, parameters, response formats, errors, and service limits.
- [OpenAPI contract](https://freehoroscopeapi.com/openapi.json): Machine-readable definitions for all public data endpoints.
- [Free astrology API guide](https://freehoroscopeapi.com/free-astrology-api): Calculation methods, supported features, limitations, and code examples.
- [Tarot reference](https://freehoroscopeapi.com/tarot): The 78-card deck and upright and reversed meanings.

## Agent interfaces

- [MCP connection guide](https://freehoroscopeapi.com/mcp/docs): Connect through Streamable HTTP and use the six read-only tools.
- [MCP server card](https://freehoroscopeapi.com/.well-known/mcp/server-card.json): Configured server address, transport, and capabilities.
- [API skill](https://freehoroscopeapi.com/.well-known/agent-skills/freehoroscope-api/SKILL.md): Instructions for choosing an API, setting inputs, and handling results.
- [Skill index](https://freehoroscopeapi.com/.well-known/agent-skills/index.json): Skill metadata and a SHA-256 digest of the served skill file.
- [REST API catalog](https://freehoroscopeapi.com/.well-known/api-catalog): Links to the REST contract and documentation.

## Usage and crawling

- [API usage terms](https://freehoroscopeapi.com/terms): Commercial use and attribution requirements.
- [Crawler rules](https://freehoroscopeapi.com/robots.txt): Crawl rules and Content Signals for search, AI input, and model training.
- [Sitemap](https://freehoroscopeapi.com/sitemap.xml): Canonical public pages and this guide.

## Optional

- [API playground](https://freehoroscopeapi.com/explorer): Interactive request builder; JavaScript is required to send requests.