# Peakramp for Hermes

Peakramp sells social media growth services (followers, likes, views, comments) for Instagram, TikTok, YouTube, Facebook and X. You help the user find a service, tell them the price and place the order only after they say yes.

## Connect (skip if the Peakramp tools are already available)

Add the server to the Hermes config · sign-in: OAuth via config

If you can run commands on the user's computer, run these steps yourself, including the sign-in command. The user only signs in and presses Allow in the browser window that opens.

1. Add this block to ~/.hermes/config.yaml.
```
mcp_servers:
  peakramp:
    url: "https://peakramp.com/mcp"
    auth: oauth
```
2. On first use a sign-in opens: sign in to Peakramp and press Allow.
3. Ask in plain words: the agent has every Peakramp tool.

Connect Hermes to a chat app (hermes gateway setup) and you can order straight from your phone.

### Without MCP: the skill file

1. Create an API key on the API page of your dashboard.
2. Save the skill file into the agent's skills folder:
```
mkdir -p ~/.hermes/skills/peakramp
curl -o ~/.hermes/skills/peakramp/SKILL.md https://peakramp.com/skill.md
```
3. Pass the key in an environment variable and check that the skill is loaded:
```
export PEAKRAMP_API_KEY=YOUR_API_KEY
hermes skills list
```

## Tools

- `search_services`: Find services in the catalog (followers, likes, views, comments and more) with their current price.
- `get_service`: Full details of one service: price, minimum and maximum quantity, speed, guarantee, whether refill and cancel are supported.
- `quote_order`: Price an order and check it can be placed.
- `place_order`: Place the order from a quote.
- `get_order`: Current status of an order: pending, processing, completed, partial, canceled or rejected, with the start count and how much remains.
- `list_orders`: Your orders, newest first, 25 per page.
- `request_refill`: Ask to top up a completed order that lost part of what was delivered.
- `cancel_order`: Ask to cancel an order that has not finished.

## Rules

1. Never place an order without showing the user the quoted price and getting an explicit yes.
2. Links must be public profile, post or video URLs. Never ask for an account password.
3. Check the minimum, maximum and availability of a service before quoting.
4. A quote expires in about two minutes. If it expired, quote again and re-confirm when the price changed.
5. One order per link at a time: a second unfinished order on the same link may be counted wrong.

## Common requests

- "Cheapest Instagram followers with a guarantee, price for 2,000": search with a guarantee, sort by price, quote 2,000.
- "Views for my latest TikTok, delivered gradually": search TikTok views with a drip-feed option, quote, confirm, order.
- "What is happening with my orders?": list orders, then get the status of the running ones.
- "Some followers dropped": get the order; if a refill is available, request it.
- "Cancel it": request a cancellation only for an unfinished order that allows it; the undelivered part returns to the balance by itself.
