# RoxyAPI MCP server

> Provides a comprehensive TypeScript SDK for astrology, Vedic astrology, tarot, numerology, and other spiritual domains for AI agents and applications.

- Repository: https://github.com/RoxyAPI/sdk-typescript
- Page: https://hostedmcp.org/servers/roxyapi/sdk-typescript
- Transport: stdio
- Stars: 1
- License: MIT

## Install

### Claude Code

```sh
claude mcp add sdk-typescript -- npx -y @roxyapi/sdk
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "sdk-typescript": {
      "command": "npx",
      "args": [
        "-y",
        "@roxyapi/sdk"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "sdk-typescript": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@roxyapi/sdk"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"sdk-typescript","type":"stdio","command":"npx","args":["-y","@roxyapi/sdk"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "sdk-typescript": {
      "command": "npx",
      "args": [
        "-y",
        "@roxyapi/sdk"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add sdk-typescript -- npx -y @roxyapi/sdk
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.sdk-typescript]
command = "npx"
args = ["-y", "@roxyapi/sdk"]
```

### Gemini CLI

```sh
gemini mcp add -s user sdk-typescript npx -- -y @roxyapi/sdk
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "sdk-typescript": {
      "command": "npx",
      "args": [
        "-y",
        "@roxyapi/sdk"
      ]
    }
  }
}
```

## FAQ

### How do I add astrology features to my Node.js app?

You can install the SDK via npm or bun and use the createRoxy function with your API key to access various astrology and spiritual endpoints.

### Does the SDK handle location and timezone data?

Yes, it includes a location API to search cities and geocode them, providing the latitude, longitude, and IANA timezone required for chart generation.