# perceptdot

> Your agent's app store. One install — your agent discovers and connects to external services automatically.

perceptdot is an MCP server platform that gives AI agents direct read access to external services (GA4, Vercel, GitHub, Sentry) and measures the ROI of each agent action. Built for the B2A2H model: Business → Agent → Human.

## Quick Start

Install the discovery layer:
```
npx @perceptdot/core
```

Then install individual service servers:
```json
{
  "mcpServers": {
    "perceptdot-core": { "command": "npx", "args": ["-y", "@perceptdot/core"] },
    "perceptdot-ga4": { "command": "npx", "args": ["-y", "@perceptdot/ga4"], "env": { "PERCEPTDOT_API_KEY": "your-key", "GA4_PROPERTY_ID": "your-id" } },
    "perceptdot-vercel": { "command": "npx", "args": ["-y", "@perceptdot/vercel"], "env": { "PERCEPTDOT_API_KEY": "your-key", "VERCEL_TOKEN": "your-token" } },
    "perceptdot-github": { "command": "npx", "args": ["-y", "@perceptdot/github"], "env": { "PERCEPTDOT_API_KEY": "your-key", "GITHUB_TOKEN": "your-token" } },
    "perceptdot-sentry": { "command": "npx", "args": ["-y", "@perceptdot/sentry"], "env": { "PERCEPTDOT_API_KEY": "your-key", "SENTRY_AUTH_TOKEN": "your-token" } }
  }
}
```

## Packages

- **@perceptdot/core** — Agent discovery layer. `percept_discover` scans your project, `percept_recommend` searches 15+ curated MCP servers. Free and unlimited.
- **@perceptdot/ga4** — Google Analytics 4. Realtime users, top pages, events, bounce rate. Saves ~450 tokens per query vs screenshots.
- **@perceptdot/vercel** — Vercel deployments. Status, project list, latest deploy check. Ends "did it deploy?" interruptions.
- **@perceptdot/github** — GitHub. Open PRs, issues, CI workflow status. ~400 tokens saved per call.
- **@perceptdot/sentry** — Sentry. Unresolved errors from production, directly.

## Key Features

- **Auto-discovery**: `percept_discover` analyzes package.json, .env, config files and recommends matching MCP servers
- **Built-in ROI**: Every package tracks tokens saved, time recovered, and cost avoided. `percept_roi_summary` reports in plain language.
- **B2A2H model**: Agent recommends tools → Human just approves. No browsing registries.

## Pricing

- **Free Starter**: 200 calls/month, all integrations. No credit card.
- **Pro / Team**: Coming soon (unlimited calls).

## Links

- Website: https://perceptdot.com
- npm: https://www.npmjs.com/org/perceptdot
- GitHub: https://github.com/perceptdot/percept
- API: https://api.perceptdot.com
- Email: service@perceptdot.com