npm.io
0.1.2 • Published yesterdayCLI

tiny-tech

Licence
MIT
Version
0.1.2
Deps
2
Size
46 kB
Vulns
0
Weekly
0
SummaryDependencyVersions

tiny-tech

MCP server for tiny.technology — bring your tiny identity, cross-agent memory, forged tools, scheduled jobs and AI personas into any MCP client: Claude Code, Codex, Kiro, Cursor, Strands agents, ...

npx tiny-tech login    # one-time: opens the browser, click Approve

Credentials land in ~/.tiny/credentials.json (0600, 90-day token).

Hook it up

# Claude Code
claude mcp add tiny -- npx -y tiny-tech
// .mcp.json (Codex, Kiro, Cursor, any stdio MCP client)
{ "mcpServers": { "tiny": { "command": "npx", "args": ["-y", "tiny-tech"] } } }
// Strands (TypeScript)
new McpClient({ command: 'npx', args: ['-y', 'tiny-tech'] })

What your agent gets

Tool What it does
tiny_learn / tiny_recall / tiny_memories / tiny_unlearn Cross-agent memory — durable facts stored server-side (D1 + semantic search), shared between the tiny web app, telegram bots, and every MCP session
tiny_chat Talk to any tiny — the persona runs server-side with its full toolset (web access, sub-agents, scheduling, retrieval, your forged tools). Attach local images/PDFs/docs via files
tiny_events Your activity feed — job results, telegram messages, share views
tiny_search / tiny_get Discover tinys in the public universe
tiny_create / tiny_update / tiny_delete Manage your AI personas
tiny_create_tool / my_* / tiny_reload_tools / tiny_remove_tool Tool forge — persist small JS tools in your account; they mount as first-class MCP tools here AND in web chat
tiny_marketplace Browse/install community tools
tiny_schedule Cron jobs that run server-side while your laptop sleeps
tiny_share Publish a conversation snapshot as a short link; list + revoke your links
tiny_whoami / tiny_login Identity + in-session browser auth

Plus the tiny-context MCP prompt: your recent memories formatted for injection at session start.

CLI

npx tiny-tech          # start MCP server (stdio) — default
npx tiny-tech login    # browser auth
npx tiny-tech logout   # remove credentials
npx tiny-tech whoami   # identity + your tinys

Env

Var Purpose
TINY_TOKEN Bearer token — skips the credentials file (CI/headless)
TINY_API_URL Override https://tiny.technology
TINY_HOME Credentials dir (default ~/.tiny)
TINY_MODEL_PROVIDER / TINY_MODEL_API_KEY / TINY_MODEL_ID / TINY_MODEL_BASE_URL Bring your own model for tiny_chat (openai, bedrock, google, vercel, or any OpenAI-compatible base URL)

Security notes

  • The token is a user-scoped JWT accepted by tiny.technology's session-gated API — treat ~/.tiny/credentials.json like a logged-in browser.
  • Forged tools always execute in tiny's server-side sandbox (SSRF-guarded fetch, 10s/20KB limits) — never locally.
  • Authorization requires an explicit Approve click on tiny.technology; codes are single-use, 5-minute, loopback-only.

Keywords

mcpmodel-context-protocoltinymemoryagentclaudestrands