⚡ Priostack Agent Context Network (ACN)
Zero-setup, model-agnostic long-term memory and multi-agent context sharing over MCP.
Priostack ACN treats an agent's long-term memory as a network resource instead of something bolted to one LLM vendor. It is a Model Context Protocol (MCP) server, reached over JSON-RPC 2.0, where agents self-register, keep isolated context spaces, store typed facts, read them back, and share them with other agents through scoped, revocable capability grants.
The public server is live at https://priostack.com/mcp (a discoverable Streamable-HTTP MCP
endpoint; https://priostack.com/acn/rpc is a working alias).
🔥 What it gives you
- 🤖 Zero-setup onboarding — an agent self-registers via
noetic.registerand gets a bearer token. No dashboard, no UI, no credit card. - 🌐 Model-agnostic memory — the same context serves an OpenAI, Anthropic, or local-model agent; memory is decoupled from the model.
- 🤝 Scoped multi-agent sharing — grant another agent explicit content rights (
read,quote,write,share,export, ...) on a space, or let itrequest_accessand approve it. Grants are revocable and forward-only. - 🧠 Typed facts — store
declarations (rules/policies),observations (measured facts), andmeasurements, keeping "what is asserted" separate from "what was observed". - 🔌 Native MCP — connect Claude Desktop, Cursor, or any MCP client by URL, or use one of the SDKs below.
🚀 Quickstart (Python)
pip install priostack
from priostack import ACNClient
with ACNClient() as acn: # defaults to https://priostack.com/mcp
acn.register(display_name="my-agent") # self-register; token captured on the client
acn.connect() # open a session; session id captured internally
space = acn.create_space(display_name="prod-memory")
acn.store(space.space_id, objects=[
{"content": "Refunds over $500 require manager approval.", "type": "declaration"},
{"content": "Export pipeline latency was 1.8s at 14:02 UTC.", "type": "observation"},
])
hits = acn.fetch(space.space_id, query="refund") # substring content reader
for content in hits.contents():
print(content)
Persist the token.
register()returns a bearer token that is shown once. Store it (and the space id) and reconnect later withACNClient(token=...)instead of registering again.
More runnable examples in examples/: multi-agent sharing,
request & approve access,
fetch & recall,
revoke & rotate, and memory integrations for
LangChain, CrewAI, and a
Claude agent.
🤝 Multi-agent context sharing
An owner grants another agent scoped access to a space. The grant subject is the grantee's agent
id (returned by register()), and the grantee must reconnect afterward to pick up the widened
scope.
# Owner stores knowledge and grants read + quote to a worker agent.
grant = owner.grant_access(space.space_id, worker_agent_id, rights=["read", "quote"])
worker.connect() # reconnect to apply the grant
print(worker.fetch(space.space_id, query="refund").contents())
owner.revoke_access(grant.capability_ref) # immediate, forward-only
Prefer a pull model? The consumer calls request_access(space_id, rights=["read"]), the owner
list_requests() and approve_request(request_id). See
examples/request_and_approve.py.
🌍 SDKs in 15 languages
Python is the reference SDK (this repo root, on PyPI). Idiomatic clients for 14 more languages live
under clients/, each with its own quickstart and README and each implementing the exact
same wire contract (clients/SPEC.md).
| Language | Path | HTTP + JSON stack |
|---|---|---|
| Python | / · PyPI priostack |
requests |
| JavaScript (Node ≥20) | clients/javascript |
built-in fetch |
| TypeScript | clients/typescript |
global fetch (typed) |
| Java (Maven) | clients/java |
java.net.http + Jackson |
| Go | clients/go |
stdlib net/http |
| C# / .NET 8 | clients/csharp |
HttpClient + System.Text.Json |
| PHP (Composer) | clients/php |
curl |
| Ruby | clients/ruby |
stdlib net/http |
| Rust | clients/rust |
reqwest + serde |
| Kotlin (Gradle) | clients/kotlin |
java.net.http |
| Swift (SwiftPM) | clients/swift |
URLSession + Codable |
| C++17 | clients/cpp |
libcurl + nlohmann/json |
| Dart | clients/dart |
package:http |
| Scala | clients/scala |
java.net.http + uPickle |
| Shell | clients/shell |
curl + jq |
Each client unwraps the MCP envelope, captures the session id, raises typed errors on tool denials,
and reuses one HTTP connection. The Python, JavaScript, TypeScript, Java, Ruby, and C++ clients have
been run end-to-end against the live server; the rest are verified against the contract and build in
CI (see .github/workflows/ci.yml).
🛠️ Use it from an MCP client (Claude Desktop, Cursor)
The ACN is a discoverable Streamable-HTTP MCP server, so an MCP client connects by URL. Ready-made
configs are in examples/mcp_config/.
Claude Desktop (Settings → Developer → Edit Config), via the mcp-remote bridge:
{
"mcpServers": {
"priostack-acn": { "command": "npx", "args": ["-y", "mcp-remote", "https://priostack.com/mcp"] }
}
}
Cursor (native remote MCP by URL):
{ "mcpServers": { "priostack-acn": { "url": "https://priostack.com/mcp" } } }
Sanity-check discovery yourself:
curl -s https://priostack.com/mcp -H 'Content-Type: application/json' -H 'Accept: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | jq '.result.tools | length'
📖 API reference (JSON-RPC 2.0)
Endpoint: https://priostack.com/mcp (alias https://priostack.com/acn/rpc).
Every call is a tools/call:
{"jsonrpc":"2.0","id":1,"method":"tools/call",
"params":{"name":"noetic.store","arguments":{ "sessionId":"...", "space":"space-1", "objects":[...] }}}
The response wraps the result envelope as text; unwrap it as
JSON.parse(response.result.content[0].text) to get {ok, outcome, data, detail?}. On ok:false
the outcome is one of not-found, invalid-query, capability-denied, policy-denied,
requires-governance, stale-base, integrity-fault, conflict, capacity-exhausted,
not-implemented. (Every SDK above does this unwrapping and error mapping for you.)
| Method | Purpose | Key arguments | Notes |
|---|---|---|---|
noetic.register |
Self-register an agent | displayName |
returns data.token (shown once) |
noetic.connect |
Open a session | token, maxResponseTokens |
returns data.SessionID (PascalCase) |
noetic.create_space |
Create a context space | sessionId, displayName, defaultRights |
returns data.spaceId |
noetic.store |
Persist typed facts | sessionId, space, objects[] |
type ∈ declaration | observation | measurement |
noetic.fetch |
Read stored content back | sessionId, space, query, limit |
substring filter; this is the reader |
noetic.grant |
Grant scoped access | sessionId, subjectPrincipal, resource, rights[], worldMutation |
space arg is resource; grantee reconnects |
noetic.revoke |
Revoke a capability | sessionId, capabilityRef |
immediate, forward-only |
noetic.request_access |
Ask for access | sessionId, space, rights[], reason |
rights arg is rights |
noetic.list_requests |
List pending requests | sessionId |
owner side |
noetic.approve_request |
Approve a request | sessionId, requestId, rights[] |
mints the grant |
noetic.discover |
List public spaces | query, limit |
no session required |
noetic.metrics |
Usage for the session | sessionId |
account + space gauges |
noetic.rotate_token |
Mint a fresh token | sessionId |
retires the old token |
noetic.disconnect |
End the session | sessionId |
durable facts are kept |
fetchvsquery:noetic.fetchreturns stored content (substring-filtered).noetic.queryis a geometric divergence probe over the memory, not a content read — don't reach for it to read facts back.
There are ~40 tools in total; every SDK exposes a generic call(method, arguments) escape hatch to
reach the ones not wrapped explicitly.
🧪 Development
pip install -e ".[dev]"
pytest # unit tests (mocked transport, no network)
ruff check src tests
CI (GitHub Actions) runs the Python test suite and builds/type-checks every language client on each pull request.
📄 License
MIT. See LICENSE.
Metadata
Release files for priostack 0.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| priostack-0.2.0.tar.gz | 234.4 kB | Without provenance | Details for priostack-0.2.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| priostack-0.2.0-py3-none-any.whl | Python 3 | none | any | Details for priostack-0.2.0-py3-none-any.whl |
Total release size: 250.9 kB
Release files / priostack-0.2.0.tar.gz
| Download URL | priostack-0.2.0.tar.gz |
|---|---|
| Size | 234.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
8044170ed65e9c3024f9bc34a83cf0e9e1396862d52245f84a030e75202f4c54
|
|
BLAKE2b-256 checksum How to use checksums |
ec20470cef7acf89ca16f1b2f6868f36a5565b90ba953247127bb119ebe896fe
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
Release files / priostack-0.2.0-py3-none-any.whl
| Download URL | priostack-0.2.0-py3-none-any.whl |
|---|---|
| Size | 16.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
26bfbaa1f8acf269fd2a598e4ef3bd80798f9ba2788f5d25ae96da81fadada63
|
|
BLAKE2b-256 checksum How to use checksums |
1bd7d94dd21ec5147ec76cd8dc78a087233c12767dcef82bcf7f7253630df444
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
Security for priostack 0.2.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.