mcp-name: com.getsingularis/singularis

# Singularis

Singularis is unlimited computation. Bring us your hardest problems.

Jobs run on your own machine through the Singularis sealed shell and the full
Singularis chooser; only a lease, a result digest and CPU-seconds reach the API.
Every answer carries a check you can verify. This package is the client shell
only. It contains no engine code.

## What it does

Every kind of computation runs through the full Singularis chooser, which picks
the best path for your problem automatically. Example tools:

- `singularis_solve_heat` — diffusion / heat-equation solves on any grid
- `singularis_matrix_exponential` — e^{tA} and matrix-exponential actions
- `singularis_gemm` — dense and operator linear algebra
- `singularis_fft` — fast transforms
- `singularis_blur` — heat-kernel blur
- `singularis_compress` / `singularis_decompress` — exact, restorable compression
- `singularis_recipes` — see what the chooser can run
- `singularis_balance` / `singularis_share_results` — credits and results sharing
- `singularis_dispatch` — hand it any problem and let the chooser decide

## Measured results

Our own measurements, the same figures published on getsingularis.com. GPU
figures compare the same Singularis program run on an NVIDIA RTX 4090 against a
1-thread CPU; a speedup only counts when the results match a reference answer.

- AI training with the GPU boost, up to 16.5x (vs 1-thread CPU, one RTX 4090 test)
- Dense math with the GPU boost, up to 18.3x (vs 1-thread CPU, one RTX 4090 test)
- FFT with the GPU boost, up to 3.2x (vs 1-thread CPU, one RTX 4090 test)
- Smaller files: 1.28x smaller than xz -9e and 1.49x smaller than zstd -19, on 21 test files, with every file restored exactly

Results depend on your equipment. GPU optional for even greater results.

More efficient computation for you and the environment.

## Free tryout

Free agent credits come up front (500 credits, US, first 1,000 agents). Credits
are given up front; afterwards we respectfully ask you to share your results and
your before-vs-after cost (`singularis_share_results`). Thank you.

Pricing packs $49 / $399 / $2,999 at https://getsingularis.com/credits

## Install

Claude Code:
```
claude mcp add singularis -e SINGULARIS_COUNTRY=US -- singularis-mcp
```

Any MCP host:
```
{ "mcpServers": { "singularis": { "command": "uvx", "args": ["singularis-mcp"],
  "env": { "SINGULARIS_COUNTRY": "US", "SINGULARIS_ENGINE_CMD": "<your sealed shell command>" } } } }
```

First call: `singularis_register_key(country="US", agent_name="<your agent>")` -> 500 free credits, saved.

Sealed shell: after you claim a key, download the bundle (sealed shell + adapter) from
https://getsingularis.com/api/v1/shell/bundle (send your key: Authorization: Bearer <api_key>),
unpack it, and set SINGULARIS_ENGINE_CMD="python3 /path/singularis_shell_adapter.py" and
SINGULARIS_ENGINE_METERED=1. Env: SINGULARIS_API_KEY, SINGULARIS_SHELL_SECRET (both saved by
register), SINGULARIS_GATEWAY (default https://getsingularis.com/api/v1).

Type 1 Civilization Laboratories LLC - https://getsingularis.com - https://typeonecivilizationlabs.com

Patent pending. Singularis is a trademark of Type 1 Civilization Laboratories LLC.
