Metadata-Version: 2.4
Name: singularis-mcp
Version: 0.1.9
Summary: Singularis is unlimited computation. Bring us your hardest problems. Free tryout. Results depend on your equipment. GPU optional for even greater results. MCP server for AI agents; free tryout credits up front. Client shell only, no engine code.
Author: Type 1 Civilization Laboratories LLC
License: Proprietary shell; free to install and use with a Singularis key
Project-URL: Homepage, https://getsingularis.com
Project-URL: Documentation, https://getsingularis.com/llms.txt
Project-URL: Repository, https://github.com/oov1317/singularis-mcp
Keywords: mcp,model-context-protocol,agents,computation,hpc,gpu,numerical,singularis
Requires-Python: >=3.10
Description-Content-Type: text/plain
License-File: LICENSE
Requires-Dist: mcp>=1.2
Requires-Dist: httpx>=0.27
Requires-Dist: numpy>=1.24
Provides-Extra: images
Requires-Dist: pillow>=10; extra == "images"
Dynamic: license-file

mcp-name: com.getsingularis/singularis

# Singularis

Singularis is unlimited computation. Bring us your hardest problems.

Jobs run on your own machine through the Singularis runtime 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. Patent pending.

**Live now (October 15, 2026):** the API is publicly open and verified end to end — claim, lease, on-device compute, signed receipt. Free agent trial: 500 credits for the first 1,000 agents (US), in exchange for posted metrics and a short prior-cloud vs Singularis cost review. Results depend on your equipment. You have the option of using a GPU for even greater results.

**Claim a free agent key (instant, 500 credits):** https://getsingularis.com/docs  
OpenAPI: https://getsingularis.com/openapi.json

## 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 (a `.sing` stream, restored bit-exact; the restore is hash-verified before the job reports success)
- `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

Claim a free agent key instantly: 500 credits, US, first 1,000 agents, no card,
no per-job limit, nothing required at claim. After you use your credits, 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 Singularis runtime command>" } } } }
```

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

## Get the runtime (jobs run on your machine)

The client never ships engine code: the Singularis runtime arrives separately,
as a sealed bundle tied to your key. Four steps:

1. Install the engine's Python dependencies:
   ```
   pip install numpy scipy cryptography pqcrypto zstandard
   ```
2. Call `singularis_register_key(country="US", agent_name="<your agent>")` once
   (above). It saves your API key and shell secret to
   `~/.singularis/credentials.json`.
3. Download the engine bundle with your key and unpack it:
   ```
   curl -H "Authorization: Bearer <your api_key>" https://getsingularis.com/api/v1/shell/bundle -o singularis-shell-bundle.tar.gz
   tar xzf singularis-shell-bundle.tar.gz
   ```
   Keep the unpacked files together: `singularis_shell_adapter.py`,
   `sing_shell.py`, `pqchan.py`, `engine.sealed`.
4. Point the MCP server at the runtime, in your MCP host config env:
   ```
   SINGULARIS_ENGINE_CMD   = "python3 /full/path/singularis_shell_adapter.py"
   SINGULARIS_ENGINE_METERED = "1"
   SINGULARIS_SEALED       = "/full/path/engine.sealed"   (optional; defaults beside the adapter)
   ```
   The adapter leases, runs locally and settles each job with a signed receipt;
   nothing is billed twice. Then use any tool.

Singularis runs on your own computer and talks to the Singularis API at
https://getsingularis.com/api/v1. Env: SINGULARIS_API_KEY, SINGULARIS_COUNTRY.

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

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