TetreesAgent_EX README

The project's README from github.com/TetreesEX/TetreesAgent_EX. As one markdown file: README.md.

Tetrees Agent EX

Public integration kit for using, growing, buying, and publishing Tetrees AI Packs through the hosted Tetrees Agent MCP and API.

Tetrees Agent selecting useful intelligence from a holographic shelf

Explore Tetrees AI Packs  ·  Connect through MCP  ·  Publish an AI Pack

This repository is the public @tetrees/mcp product (ai.tetrees/mcp): the stdio MCP server, clients, configuration examples, and safe extension samples. It does not contain Tetrees Agent internals, private Pack intelligence, Agent AVCP scoring, service prompts, storage, moderation, or exchange infrastructure.

What you can build

Path Use this kit to
Buyer / operator Search Packs, inspect the public Agent AVCP report, quote a run, try a Pack with Tetrees Points, acquire a free Pack, and download an owned .taip release.
Builder Connect an auditioned Pack to a user-owned HTTPS API, nested MCP server, or no-shell local skill while keeping credentials local.
Seller Create a listing, upload an immutable .taip version and images, inspect readiness, run Agent AVCP, read private repair feedback, and publish a passing release.

Tetrees-hosted work needs no local GPU. Model-funded runs are quoted in Tetrees Points before execution; an owned Pack can also use a supported provider key supplied to the local MCP process.

Quick start: hosted MCP

Requirements: Node.js 20+ and a revocable API token from Tetrees Account.

Add this to your MCP client's configuration:

{
  "mcpServers": {
    "tetrees-ai": {
      "command": "npx",
      "args": ["-y", "https://ex.tetrees.ai/pkg/tetrees-mcp.tgz?v=2.2.1"],
      "env": {
        "TETREES_API_URL": "https://ex.tetrees.ai/api",
        "TETREES_TOKEN": "<revocable-account-token>"
      }
    }
  }
}

Restart the MCP client, then ask it to:

Search Tetrees AI Packs for repository issue triage. Show the public Agent AVCP
report and runtime profile for the best match, then quote an 8k/2k Point-funded
run. Do not run it until I approve the quoted maximum.

Do not put provider keys in a Pack, prompt, source file, or shared MCP config. Optional BYOK keys belong only in the local MCP process environment. See examples/mcp/mcp-config.jsonc.

Inspect the MCP contract

npm install
export TETREES_TOKEN="txk_..."
npm run mcp:inspect

The inspector launches the official hosted MCP package, lists its public tools and resources, checks the expected buyer/builder/seller surface, and exits without spending Points or changing account state.

The v=2.2.1 suffix is intentional: it prevents npx from reusing an older MCP tarball cached under the same URL. Change it only when Tetrees publishes a newer MCP contract. The npm identity for the same package is @tetrees/[email protected].

Public API CLI

Copy .env.example values into your shell; this project deliberately does not auto-load secret files.

export TETREES_TOKEN="txk_..."

# Read-only calls
npm run tetrees -- status
npm run tetrees -- catalog "research"
npm run tetrees -- models
npm run tetrees -- skills
npm run tetrees -- owned
npm run tetrees -- runtime <pack-id>
npm run tetrees -- report <pack-id>

# Quote first. This never starts a model request.
npm run tetrees -- quote <pack-id> <model-id>

# A Point-spending run needs the exact confirmation flag.
npm run tetrees -- run <pack-id> <model-id> "Your task" --confirm-spend

The CLI redacts secret-shaped response fields and reports Tetrees error codes, HTTP status, and Retry-After. It does not retry a mutation automatically.

Buyer flow

  1. Search for a Pack.
  2. Inspect its public Agent AVCP report and runtime profile.
  3. Quote the exact model, token ceiling, hosted skills, and growth checkpoint.
  4. Run a Point-funded stateless preview. Unused reserved Points return.
  5. Acquire a free Pack or buy a paid Pack on Tetrees EX.
  6. Ownership unlocks download, BYOK, saved growth, and client extensions.

Run the documented read-only example:

node examples/buyer/discover-and-quote.mjs "incident response"

Builder flow: add capabilities without giving them to Tetrees

A published Pack may declare client extensions that passed Agent AVCP. The actual binding and credentials remain on the user's machine.

Supported binding patterns:

Start with:

Tetrees hosting never inherits these local permissions. A write method needs the exact per-call phrase APPROVE extensionId.methodId.

Seller flow

The supported publisher path is intentionally contract-driven:

# Read-only readiness/report inspection
node examples/seller/check-readiness.mjs <pack-id>

# Upload one higher immutable version. Requires explicit confirmation.
node examples/seller/upload-pack.mjs <pack-id> 1.1.0 ./release.taip --confirm-upload

Then use the hosted MCP tools or Tetrees API reference to submit, quote Agent AVCP, run it after confirming the exact Point amount, inspect the private report, and publish only the passing digest.

See docs/SELLER_GUIDE.md and examples/seller/pack-listing.example.json.

Stable public references

Security and product boundary

This repository does not contain:

The examples operate only through the documented public, authenticated contract. Review SECURITY.md and docs/PUBLIC_BOUNDARY.md before contributing.

Verify this repository

npm test
npm run check:public-boundary
npm pack --dry-run

License

The client examples and documentation in this repository are MIT licensed. Tetrees, Tetrees Agent, Tetrees AI Pack, TAIP, and Agent AVCP names and service marks remain the property of Tetrees EX. The license does not grant access to, or rights in, the hosted service or private Pack intelligence.

TetreesAgent_EX (TetreesEX/TetreesAgent_EX)

Searching Database…

302 ·GitHub
TetreesAgent_EX
Что это?Это публичный набор для интеграции с Tetrees Agent - hosted MCP-сервисом и маркетплейсом, где можно искать, покупать, продавать и запускать ИИ-«паки» (ИИ-агентов), не имея собственного GPU.
Это сам ИИ-агент или только публичный набор для общения с ним?Это только публичный продукт @tetrees/mcp: stdio MCP-сервер, клиенты, примеры конфигурации и образцы расширений. Внутренности Tetrees Agent, скоринг, модерацию и биржевую инфраструктуру он сознательно не включает.
Как подключиться к hosted MCP?Добавьте запись hosted MCP в конфигурационный файл вашего MCP-клиента и перезапустите клиент; после этого можно просить его искать, запрашивать расценки и запускать паки.
Что нужно перед началом?Node.js 20+ и отзывной API-токен, созданный в вашем аккаунте Tetrees.
Нужен ли свой GPU или ключи провайдера, чтобы запустить пак?Нет - hosted-запуски тарифицируются и оплачиваются в Tetrees Points, локальный GPU не нужен, хотя собственный пак может опционально использовать ваш ключ провайдера (BYOK), который хранится только в локальном процессе MCP.
Для кого на самом деле этот набор?Три роли: покупатели/операторы, которые ищут, предварительно просматривают и запускают паки; билдеры, которые прикрепляют к паку локальные HTTPS API, вложенные MCP-серверы или скиллы без shell; и продавцы, которые создают, тестируют и публикуют листинги паков.
Где оказываются учётные данные моих расширений?Привязки расширений билдера (HTTPS API, вложенный MCP или локальный скилл) и их учётные данные остаются на вашей машине; хостинг Tetrees эти локальные разрешения никогда не получает.
Что именно покрывает здесь лицензия MIT?По MIT лицензированы только клиентские примеры и документация в этом репозитории; имена и знаки Tetrees остаются собственностью Tetrees EX, а лицензия не даёт прав на hosted-сервис или закрытую «начинку» паков.
Что такое Tetrees Points?Это кредиты, которыми оплачиваются запуски моделей на hosted-сервисе; расценка резервирует Points до выполнения, а неиспользованный зарезервированный объём возвращается после превью.
Что такое Agent AVCP?Это внутренний процесс скоринга/аудита Tetrees, который пак должен пройти перед публикацией или перед подключением как клиентское расширение; правила скоринга и фикстуры остаются закрытыми и в этом репозитории отсутствуют.
Какие схемы привязки может использовать билдер, чтобы расширить пак?Три схемы: httpsapi (фиксированный HTTPS base URL с объявленными методами), mcp (вложенный MCP-сервер) и localskill (дочерний процесс без shell, обменивающийся одним JSON-запросом и одним результатом).
Зачем команда MCP-инспектора фиксирует v=2.2.1?Суффикс версии не даёт npx переиспользовать более старый закэшированный tarball MCP по тому же URL; менять его стоит только когда Tetrees выпустит новый контракт MCP.
What are similar projects?executor, gitagent, context7, kimi-code, rea, headroom, mcporter, servers
Which topics is it in?mcp-client, marketplace, byok, saas, model-context-protocol, sdk, mcp-server, agent, mcp, security, npm, api
Creator
TetreesEX
Size
0.2 MB
Stars
302
Updated
CommitOct 09
Age
1mo
Commits · 90 Days