Authshore

as

[npm version] [MCP] [Remote MCP]

Auth infrastructure for coding agents — user pools, secrets vault, token management. As easy as git.

git for your code. as for your auth.

Your agent can scaffold a whole app in an afternoon — then stalls the moment it needs auth. It hardcodes secrets into .env files it later commits, rolls its own JWT handling, and leaves you wiring up Cognito by hand. AuthShore is the auth layer your agent runs itself: one install, and it provisions user pools, stores secrets encrypted, and mints, validates and refreshes tokens — from the terminal, with no console to click through.

Works with: Claude Code · Cursor · Cline · Windsurf · Aider · Codex · any MCP client

See It In Action

Real terminal sessions against the live API — click a GIF for the full video.

More demos: authshore.ai/#demo

Install

npm install -g authshore

The npm package is authshore; the command is as.

Quick Start

# 1. Create a project — free plan, API key active immediately, no cardas signup my-project --email [email protected] --local
# 2. Create a user poolas pool create main
# 3. Store a secret (encrypted at rest, versioned)as secret set DATABASE_URL "postgres://user:pass@host:5432/db"
# 4. Sign up a user in your poolas pool auth signup main --email [email protected] --password SecurePass123!
# Full referenceas help

User Pools — Cognito without the console

Every project gets isolated user pools your agent manages from the terminal: create pools, add users, run full signup/signin flows that return real JWT pairs.

as pool create main                      # create a poolas pool list                             # list poolsas pool users <id>                       # list users in a poolas pool user add <id> --email E --password Pas pool auth signup <id> --email E --password P   # returns access + refresh tokensas pool auth signin <id> --email E --password P

Secrets Vault — stop pasting keys into .env

Encrypted, versioned key-value storage scoped to your project. Your agent stores third-party keys once and reads them at deploy time — nothing sensitive left sitting in the repo.

as secret set STRIPE_KEY "sk_..." --env productionas secret get STRIPE_KEY                 # decrypted readas secret listas secret versions STRIPE_KEY            # full version historyas secret delete STRIPE_KEY

Tokens — mint, validate, refresh, revoke

The JWT plumbing agents usually hand-roll, done right once.

as token validate <jwt>                  # verify signature + expiry, show claimsas token refresh <refresh-token>         # rotate the pairas token revoke <token>                  # kill a compromised token

MCP Server

Prefer tools over a CLI? as ships an MCP server. Point Claude Code (or any MCP client) at it and your agent gets 18 native tools: pools, users, secrets, tokens, project status.

claude mcp add authshore --env AUTHSHORE_API_KEY=as_your_key_here -- as mcp-serve

For clients that use a JSON config (Cline, Cursor, Windsurf), pass your API key via the AUTHSHORE_API_KEY environment variable. The MCP server runs outside your project directory, so it will not pick up .authshore/config.json:

{  "mcpServers": {    "authshore": {      "command": "as",      "args": ["mcp-serve"],      "env": { "AUTHSHORE_API_KEY": "as_your_key_here" }    }  }}

No key yet? as signup my-project --email [email protected] provisions one in seconds — free plan, no card.

Remote MCP — zero install

No CLI at all? Claude Web, Claude Desktop, Raycast, or any hosted MCP client can connect straight to our remote server. Same 18 tools, nothing to install:

URL:  https://mcp.authshore.ai/sseAuth: Authorization: Bearer YOUR_API_KEY

No key? Connect without one: the remote server starts in onboarding mode with an authshore_signup tool that provisions your account and unlocks everything in the same session.

Features

• User pools - isolated pools per project, full signup/signin flows, real JWT pairs
• Secrets vault - encrypted at rest, versioned, environment-scoped
• Tokens - validate, refresh, revoke from the terminal
• MCP server - 18 tools, local (as mcp-serve) or fully remote (mcp.authshore.ai): Claude Code, Claude Web, Cursor, Raycast, any MCP client
• Agent-first CLI - --json on every command for programmatic parsing
• Project-local config - .authshore/config.json, auto-loaded, gitignore-friendly

Pricing: free plan with an instantly-active API key — no card, no trial clock. Paid plans (Starter $9 / Pro $29 / Scale $99 per month) come with a 7-day free trial via secure Stripe checkout. Details.

Config

as login --key YOUR_KEY --local     # saves to .authshore/config.json (project-local)as config                           # show active configas me                               # identity check: which project am I?

API key is resolved in this order (highest priority first):

1. --key flag
2. AUTHSHORE_API_KEY environment variable
3. ./.authshore/config.json (project-local)
4. ~/.authshore/config.json (global)

Add .authshore/ to your .gitignore.

Agent Integration

Add to your CLAUDE.md, .cursorrules, .clinerules, .windsurfrules, or AGENTS.md:

## AuthThis project uses AuthShore for auth: user pools, secrets, tokens.Use the `as` CLI. Config is in .authshore/config.json (auto-loaded).If not configured: as login --local --key YOUR_KEYRun `as help` for the full command reference. Run `as me` before any writes.

Why this exists

Every agent-built app hits the same wall: auth. I watched my agents hardcode secrets, reinvent JWT refresh, and stall on Cognito consoles they can't click. So I built the auth layer the agent runs itself. It's early and I'm iterating fast: if something's rough or missing, open an issue — I read every one.

Documentation

• Quickstart Guides
• Full Reference
• Status

License

Proprietary - Tyga.Cloud Ltd. See LICENSE.