# PromptEden Agent Skill

PromptEden lets agents provision API access and pull AI visibility data without using the browser UI.

## Fastest Path

Create an agent workspace and API key:

```bash
curl -sS https://app.prompteden.com/api/v1/agent/sign-up \
  -H "content-type: application/json" \
  -d '{
    "humanEmail": "owner@example.com",
    "agentName": "VisibilityScout",
    "websiteUrl": "example.com"
  }'
```

The response includes a one-time `apiKey` beginning with `pe_`. Store it only in process memory or your secret manager. Do not send it anywhere except `https://app.prompteden.com`.

Use the key:

```bash
export PROMPTEDEN_API_KEY="pe_..."

curl -sS https://app.prompteden.com/api/v1/agent/status \
  -H "Authorization: Bearer $PROMPTEDEN_API_KEY"

curl -sS https://app.prompteden.com/api/v1/account \
  -H "Authorization: Bearer $PROMPTEDEN_API_KEY"

curl -sS https://app.prompteden.com/api/v1/projects \
  -H "Authorization: Bearer $PROMPTEDEN_API_KEY"
```

## Existing Accounts

If the human gives you existing PromptEden credentials, mint a new API key without creating a browser session:

```bash
curl -sS https://app.prompteden.com/api/v1/agent/sign-in \
  -H "content-type: application/json" \
  -d '{
    "email": "owner@example.com",
    "password": "human-supplied-password",
    "keyName": "VisibilityScout"
  }'
```

## REST API

Base URL: `https://app.prompteden.com/api/v1`

Authentication: `Authorization: Bearer pe_...`

Useful endpoints:

- `GET /agent/status`
- `GET /account`
- `GET /projects`
- `POST /projects`
- `GET /monitors`
- `POST /monitors`
- `GET /monitors/{monitorId}/results`

OpenAPI: https://prompteden.com/docs/openapi.yaml

## CLI

Download the single-file CLI:

```bash
curl -fsSL https://prompteden.com/cli/prompteden.mjs -o prompteden.mjs
node prompteden.mjs account
node prompteden.mjs projects list
```

## MCP

Download the stdio MCP server:

```bash
curl -fsSL https://prompteden.com/mcp/prompteden-mcp.mjs -o prompteden-mcp.mjs
PROMPTEDEN_API_KEY="$PROMPTEDEN_API_KEY" node prompteden-mcp.mjs
```

The MCP server exposes account, project, monitor, and result tools over JSON-RPC stdio.

## More Context

- Agent hub: https://prompteden.com/agents/
- llms.txt: https://prompteden.com/llms.txt
- llms-full.txt: https://prompteden.com/llms-full.txt
- agents.json: https://prompteden.com/agents.json
- MCP metadata: https://prompteden.com/.well-known/mcp.json