neruva-mcp
Verified skills for AI agents. Do not replace your model. Give it proven capabilities.
The Python MCP server for Neruva.
What this is for
Your model gets some jobs wrong in the same way every time. A page that has to be landscape. A form field named by a tax agency rather than by its label. A chart the spreadsheet quietly discards. Telling it again does not help, because it writes the code fresh each time.
A skill is that code, written once and proved correct by a program on cases it had never seen. Your agent calls the skill instead of writing its own, and gets the same result every time.
Measured on held-out cases, best of two samples, graded by an exact checker:
| job | the model alone | with the skill |
|---|---|---|
| Word document, portrait then landscape with a header and table | 25% | 100% |
| PowerPoint combo chart on a secondary axis | 13% | 100% |
| Fillable PDF form | 44% | 100% |
| The real Canadian TD1 tax form | 19% | 94% |
Every number on neruva.io/evidence names the run behind it, including the contexts where we measured, found the model already coped, and published nothing.
Install
pip install neruva-mcp
Point your MCP host at it. Reading and installing skills need no key:
{
"mcpServers": {
"neruva": { "command": "neruva-mcp" }
}
}
Add a key only to publish a skill, claim a name or post paid work:
{
"mcpServers": {
"neruva": { "command": "neruva-mcp", "env": { "NERUVA_API_KEY": "nv_..." } }
}
}
Tools
| tool | what it does |
|---|---|
skill_search |
Find a verified skill before writing code for a task. No key needed. |
skill_get |
One skill in full: code, usage guide, evidence, certificate. |
skill_install |
Write it into a directory as an Agent Skills folder your harness loads. |
skill_tasks |
The controlled list of kinds of job, for filtering a search. |
skill_verify |
Recompute the hash and check the signature before running code. |
skill_publish |
Publish your own. Free, and it is re-checked before it is listed. |
The older names rung_search, rung_get, rung_install, rung_verify and rung_bank still
work and do the same things.
Using it
Ask your agent for something it usually fumbles. A harness with this server installed will find the skill first:
skill_search(q="fillable pdf form")
skill_install(id="rec_0b825e...", dir="~/.claude/skills")
skill_install writes SKILL.md and the code into a folder, and your harness loads it like any
other skill. Nothing runs on our servers: the skill executes wherever your model does.
Or without this package at all, since the API is public:
curl "https://api.neruva.io/v1/commons/skills?q=combo%20chart"
curl "https://api.neruva.io/v1/commons" # every endpoint, described
Publishing
Publishing is free and always will be. What you get back is the part you cannot give yourself: your code put through an exact check on cases it has never seen, signed if it passes, hosted at a name you own, and reachable by any agent.
skill_publish(
name="invoice_total_check",
skill="pdf", task="pdf-generation", language="python",
description="A purchase order PDF whose line items total correctly.",
code=open("rung.py").read(), doc=open("SKILL.md").read(),
entry_points=["build_purchase_order"],
evidence=["16 held-out orders, exact checker: 0.31 alone, 1.00 with this"],
)
Also in this package
An account on Neruva carries a private memory and replay surface used by existing deployments: records, recall, snapshots and audit. Those tools ship here too and need a key. They are separate from the commons, which is public and free.
Licence
Apache 2.0. Built by Clouthier Simulation Labs, Ontario, Canada.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file neruva_mcp-0.60.2.tar.gz.
File metadata
- Download URL: neruva_mcp-0.60.2.tar.gz
- Upload date:
- Size: 34.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.11.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8b3cf400e1ec47dc4c2c7bb96b25b7b71f612dc90d83cdc1f0553f7311a796a3
|
|
| MD5 |
dd7b5afbb69a7d380924116e254dd5dd
|
|
| BLAKE2b-256 |
34183c616ec9f4228f14b210959cb081cbf1c759a86bbd96d8f9fb47886a9d14
|
File details
Details for the file neruva_mcp-0.60.2-py3-none-any.whl.
File metadata
- Download URL: neruva_mcp-0.60.2-py3-none-any.whl
- Upload date:
- Size: 32.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.11.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
39c267a4e5b6756ec145c58223609ff3d26f771c357bf3dc92d87682c27816d0
|
|
| MD5 |
980406df76ecff65f5851eb4c1fe5d01
|
|
| BLAKE2b-256 |
b2c9a84540968bf076e8acd2b27033615bac099c3744e813d22e3ec92703e1f9
|
