Skip to content

Commit e9fffc8

Browse files
ph33nxph33nx
committed
feat: RoxyAPI Claude Code plugin and marketplace generated from the live OpenAPI spec
0 parents  commit e9fffc8

17 files changed

Lines changed: 821 additions & 0 deletions

File tree

‎.claude-plugin/marketplace.json‎

Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,43 @@
1+
{
2+
"name": "roxyapi",
3+
"owner": {
4+
"name": "RoxyAPI"
5+
},
6+
"description": "RoxyAPI: the multi domain spiritual intelligence API and Remote MCP. One plugin connects Claude Code to verified astrology, Vedic, tarot, numerology, human design, forecast, and more.",
7+
"plugins": [
8+
{
9+
"name": "roxyapi",
10+
"source": "./",
11+
"description": "Connects Claude Code to RoxyAPI: a keyless Docs MCP for live endpoint lookup plus a skill that teaches Claude how to build on every RoxyAPI domain under one key.",
12+
"category": "api",
13+
"keywords": [
14+
"roxyapi",
15+
"mcp",
16+
"remote-mcp",
17+
"claude-code",
18+
"agent-skill",
19+
"astrology-api",
20+
"spiritual",
21+
"divination",
22+
"natal-chart",
23+
"kundli",
24+
"horoscope",
25+
"astrology",
26+
"vedic-astrology",
27+
"numerology",
28+
"tarot",
29+
"human-design",
30+
"forecast",
31+
"biorhythm",
32+
"iching",
33+
"crystals",
34+
"dreams",
35+
"angel-numbers",
36+
"location"
37+
],
38+
"homepage": "https://roxyapi.com",
39+
"repository": "https://github.com/RoxyAPI/claude-plugin",
40+
"license": "MIT"
41+
}
42+
]
43+
}

‎.claude-plugin/plugin.json‎

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
{
2+
"name": "roxyapi",
3+
"description": "RoxyAPI multi domain spiritual intelligence API and Remote MCP for Claude Code. Auto connects the keyless Docs MCP and ships a skill that teaches Claude how to build natal charts, Vedic kundli, tarot, numerology, human design, forecasts, and more, all under one key.",
4+
"author": {
5+
"name": "RoxyAPI"
6+
},
7+
"homepage": "https://roxyapi.com",
8+
"repository": "https://github.com/RoxyAPI/claude-plugin",
9+
"license": "MIT",
10+
"keywords": [
11+
"roxyapi",
12+
"mcp",
13+
"remote-mcp",
14+
"claude-code",
15+
"agent-skill",
16+
"astrology-api",
17+
"spiritual",
18+
"divination",
19+
"natal-chart",
20+
"kundli",
21+
"horoscope",
22+
"astrology",
23+
"vedic-astrology",
24+
"numerology",
25+
"tarot",
26+
"human-design",
27+
"forecast",
28+
"biorhythm",
29+
"iching",
30+
"crystals",
31+
"dreams",
32+
"angel-numbers",
33+
"location"
34+
]
35+
}

‎.github/workflows/ci.yml‎

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,28 @@
1+
name: CI
2+
3+
on:
4+
pull_request:
5+
push:
6+
branches: [main]
7+
8+
permissions:
9+
contents: read
10+
11+
jobs:
12+
check:
13+
runs-on: ubuntu-latest
14+
steps:
15+
- uses: actions/checkout@v6
16+
17+
- uses: oven-sh/setup-bun@v2
18+
19+
- run: bun install --frozen-lockfile
20+
21+
- name: Lint and format
22+
run: bunx biome ci .
23+
24+
- name: Typecheck
25+
run: bun typecheck
26+
27+
- name: Validate discovery, playbook fetch, and artifact build (no writes)
28+
run: bun run sync --dry-run

‎.github/workflows/sync.yml‎

Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
name: Sync plugin
2+
3+
on:
4+
schedule:
5+
- cron: '0 6 * * *'
6+
workflow_dispatch:
7+
repository_dispatch:
8+
types: [openapi-updated]
9+
10+
permissions:
11+
contents: write
12+
13+
concurrency:
14+
group: sync
15+
cancel-in-progress: false
16+
17+
jobs:
18+
sync:
19+
runs-on: ubuntu-latest
20+
steps:
21+
- uses: actions/checkout@v6
22+
23+
- uses: oven-sh/setup-bun@v2
24+
25+
- run: bun install --frozen-lockfile
26+
27+
- name: Regenerate plugin artifacts from the live spec
28+
run: bun run sync
29+
30+
- name: Commit regenerated artifacts
31+
run: |
32+
git config user.name "github-actions[bot]"
33+
git config user.email "github-actions[bot]@users.noreply.github.com"
34+
git add skills .mcp.json .claude-plugin
35+
if git diff --cached --quiet; then
36+
echo "No artifact changes."
37+
else
38+
git commit -m "sync: regenerate plugin from live OpenAPI spec"
39+
git push
40+
fi

‎.gitignore‎

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
node_modules/
2+
*.log
3+
.env
4+
.env.*
5+
!.env.example
6+
*.tsbuildinfo
7+
.DS_Store
8+
9+
# Internal maintainer notes. Not public.
10+
CLAUDE.md

‎.mcp.json‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
{
2+
"mcpServers": {
3+
"roxy-docs": {
4+
"type": "http",
5+
"url": "https://roxyapi.com/mcp/docs"
6+
}
7+
}
8+
}

‎AGENTS.md‎

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,37 @@
1+
# RoxyAPI Claude Code plugin - Agent Guide
2+
3+
This repo is a Claude Code plugin and self hosted marketplace for RoxyAPI, the multi domain spiritual intelligence API. Installing it gives Claude Code a skill plus the keyless Docs MCP for RoxyAPI.
4+
5+
## Install
6+
7+
```
8+
/plugin marketplace add RoxyAPI/claude-plugin
9+
/plugin install roxyapi@roxyapi
10+
```
11+
12+
## What ships
13+
14+
- `skills/roxyapi/SKILL.md`: model invoked skill. Teaches Claude when and how to call RoxyAPI (location first rule, `X-API-Key` auth, per domain endpoints, error contract, SDK and Remote MCP paths). Body is the live agent playbook from `https://roxyapi.com/AGENTS.md`.
15+
- `.mcp.json`: auto connects the keyless Docs MCP at `https://roxyapi.com/mcp/docs` (one tool, `search_docs`). No key needed.
16+
- `.claude-plugin/plugin.json` and `.claude-plugin/marketplace.json`: plugin and marketplace manifests.
17+
18+
## Generated, not hand written
19+
20+
Every artifact is regenerated from the live OpenAPI spec and `/AGENTS.md` by `scripts/sync.ts`. The spec at `https://roxyapi.com` is the single source of truth. Do not hand edit `skills/`, `.mcp.json`, or `.claude-plugin/`. To change the plugin, change the API.
21+
22+
## Live API calls
23+
24+
The Docs MCP is keyless. For live calls add a per domain server with your key:
25+
26+
```json
27+
{ "mcpServers": { "roxy-astrology": { "type": "http", "url": "https://roxyapi.com/mcp/astrology", "headers": { "X-API-Key": "YOUR_KEY" } } } }
28+
```
29+
30+
Get a key at https://roxyapi.com/account. See https://roxyapi.com/docs/mcp.
31+
32+
## Links
33+
34+
- MCP guide: https://roxyapi.com/docs/mcp
35+
- API reference: https://roxyapi.com/api-reference
36+
- SDKs: https://roxyapi.com/docs/sdk
37+
- Pricing: https://roxyapi.com/pricing

‎CITATION.cff‎

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
cff-version: 1.2.0
2+
message: "If you use this software, please cite it as below."
3+
title: "RoxyAPI for Claude Code"
4+
abstract: "A Claude Code plugin and marketplace for RoxyAPI, the multi domain spiritual intelligence API. Ships a skill plus the keyless Docs MCP, auto generated and kept in sync from the live OpenAPI spec."
5+
authors:
6+
- name: "RoxyAPI"
7+
url: "https://github.com/RoxyAPI/claude-plugin"
8+
repository-code: "https://github.com/RoxyAPI/claude-plugin"
9+
license: MIT
10+
type: software
11+
keywords:
12+
- claude-code
13+
- mcp
14+
- remote-mcp
15+
- agent-skill
16+
- openapi
17+
- astrology-api
18+
- vedic-astrology-api
19+
- tarot-api
20+
- numerology-api

‎LICENSE‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
MIT License
2+
3+
Copyright (c) 2026 RoxyAPI
4+
5+
Permission is hereby granted, free of charge, to any person obtaining a copy
6+
of this software and associated documentation files (the "Software"), to deal
7+
in the Software without restriction, including without limitation the rights
8+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9+
copies of the Software, and to permit persons to whom the Software is
10+
furnished to do so, subject to the following conditions:
11+
12+
The above copyright notice and this permission notice shall be included in all
13+
copies or substantial portions of the Software.
14+
15+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21+
SOFTWARE.

‎README.md‎

Lines changed: 62 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,62 @@
1+
# RoxyAPI for Claude Code
2+
3+
[![CI](https://github.com/RoxyAPI/claude-plugin/actions/workflows/ci.yml/badge.svg)](https://github.com/RoxyAPI/claude-plugin/actions/workflows/ci.yml)
4+
[![MCP docs](https://img.shields.io/badge/MCP-roxyapi.com-blue)](https://roxyapi.com/docs/mcp)
5+
[![API Reference](https://img.shields.io/badge/api%20reference-roxyapi.com-blue)](https://roxyapi.com/api-reference)
6+
[![Docs](https://img.shields.io/badge/docs-roxyapi.com-blue)](https://roxyapi.com/docs)
7+
[![Pricing](https://img.shields.io/badge/pricing-roxyapi.com-blue)](https://roxyapi.com/pricing)
8+
[![License: MIT](https://img.shields.io/badge/license-MIT-green)](./LICENSE)
9+
10+
A Claude Code plugin that teaches Claude how to build on RoxyAPI, the multi domain spiritual intelligence API: Western and Vedic astrology, tarot, numerology, horoscopes, human design, forecast, biorhythm, I Ching, crystals, dreams, angel numbers, and location. One key, every domain. Remote MCP, typed SDKs, and drop in UI components live alongside at [roxyapi.com](https://roxyapi.com).
11+
12+
One install gives Claude Code two things, no API key required:
13+
14+
- A **Skill** that tells Claude when and how to call RoxyAPI: the location first rule, `X-API-Key` auth, endpoints per domain, the error contract, and the SDK and Remote MCP integration paths.
15+
- The keyless **Docs MCP** (`search_docs`), auto connected, so Claude looks up the exact endpoint, field, or SDK method live from the reference instead of guessing.
16+
17+
Both stay current automatically. The plugin is regenerated from the live OpenAPI spec and the published agent playbook, so as the API grows the Skill grows with it.
18+
19+
## Install
20+
21+
In Claude Code:
22+
23+
```
24+
/plugin marketplace add RoxyAPI/claude-plugin
25+
/plugin install roxyapi@roxyapi
26+
```
27+
28+
That is the whole setup. Claude now reaches for RoxyAPI when you build any astrology, tarot, numerology, human design, forecast, or other insight feature, and can query the Docs MCP for exact endpoints while it writes the integration.
29+
30+
## Make live API calls
31+
32+
The Docs MCP is keyless and answers questions about the API. To let Claude call the API for real (returning live charts, readings, or forecasts), add a per domain Remote MCP server with your key. Get a key at [roxyapi.com/account](https://roxyapi.com/account), then add to your MCP config:
33+
34+
```json
35+
{
36+
"mcpServers": {
37+
"roxy-astrology": {
38+
"type": "http",
39+
"url": "https://roxyapi.com/mcp/astrology",
40+
"headers": { "X-API-Key": "YOUR_KEY" }
41+
}
42+
}
43+
}
44+
```
45+
46+
Swap `astrology` for any domain (`vedic-astrology`, `tarot`, `numerology`, `human-design`, `forecast`, and more). See the [MCP guide](https://roxyapi.com/docs/mcp).
47+
48+
## What is RoxyAPI
49+
50+
Hosted infrastructure for insight, prediction, and spiritual intelligence apps. One subscription, one API key, every domain. Calculations are powered by Roxy Ephemeris, verified against NASA JPL Horizons. Flat pricing, no AGPL, instant key delivery, typed SDKs for TypeScript, Python, PHP, C#, and Go, and Remote MCP across every domain. See the [methodology](https://roxyapi.com/methodology).
51+
52+
## Links
53+
54+
- MCP guide: [roxyapi.com/docs/mcp](https://roxyapi.com/docs/mcp)
55+
- API reference: [roxyapi.com/api-reference](https://roxyapi.com/api-reference)
56+
- SDKs: [roxyapi.com/docs/sdk](https://roxyapi.com/docs/sdk)
57+
- Templates and starters: [roxyapi.com/starters](https://roxyapi.com/starters)
58+
- Pricing: [roxyapi.com/pricing](https://roxyapi.com/pricing)
59+
60+
## License
61+
62+
MIT. See [LICENSE](./LICENSE).

0 commit comments

Comments
 (0)