From 632021762a969c09d8d5cf39eb382ed44da580c7 Mon Sep 17 00:00:00 2001 From: stuart5915 Date: Tue, 17 Mar 2026 21:47:09 -0400 Subject: [PATCH 1/4] =?UTF-8?q?Add=20Inclawbate=20skill=20=E2=80=94=20huma?= =?UTF-8?q?n=20discovery=20&=20hiring=20for=20AI=20agents?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Inclawbate is a human discovery layer for AI agents. Agents can: - Search and hire humans by skill (design, dev, content, etc.) - Pay in $CLAWS on Base (zero platform fee) - Collaborate via inbox messaging with Telegram notifications - Check ecosystem analytics (price, volume, staking TVL, APY) - Interact with on-chain staking (stake, unstake, claim, compound) - View fee reports and pending WETH earnings No API key needed. Public read endpoints, wallet-signed writes. Homepage: https://inclawbate.com Token: $CLAWS on Base (0x7ca47B141639B893C6782823C0b219f872056379) --- inclawbate/SKILL.md | 292 +++++++++++++++++++++ inclawbate/references/api-endpoints.md | 335 +++++++++++++++++++++++++ 2 files changed, 627 insertions(+) create mode 100644 inclawbate/SKILL.md create mode 100644 inclawbate/references/api-endpoints.md diff --git a/inclawbate/SKILL.md b/inclawbate/SKILL.md new file mode 100644 index 00000000..30109aa9 --- /dev/null +++ b/inclawbate/SKILL.md @@ -0,0 +1,292 @@ +--- +name: inclawbate +description: > + Inclawbate ecosystem skill — human discovery, hiring, analytics, staking, and fee management. + Agents search for humans by skill, pay in $CLAWS on Base, collaborate via inbox messaging. + Also provides real-time ecosystem analytics (price, volume, staking TVL, APY) and on-chain + staking operations. No API key needed for reads. +metadata: + openclaw: + emoji: "🦞" + homepage: "https://inclawbate.com" + requires: + bins: ["curl", "jq"] +--- + +# Inclawbate — Human APIs for AI Agents + +Human discovery and hiring layer for the OpenClaw ecosystem. Find humans by skill, pay them in $CLAWS, collaborate via inbox messaging, and build trust over repeated interactions. Also provides ecosystem analytics and on-chain staking. + +## Overview + +Inclawbate turns X/Twitter profiles into structured, agent-readable human APIs. Every human profile includes skills, bio, available capacity, response time SLA, timezone, and a wallet address for $CLAWS payments. + +Agents don't need API keys — the directory is public. Hiring creates a conversation thread where agents and humans exchange messages. Humans get Telegram notifications instantly. + +**Key differentiator:** There are no platform-imposed ratings or reviews. Agents evaluate humans on their own terms — tracking response latency, output quality, and reliability across interactions to decide which humans are worth their CLAWS. + +## Quick Start + +```bash +# 1. Search for a human with design skills +curl "https://inclawbate.com/api/inclawbate/humans?skill=design&availability=available" + +# 2. Read their full profile (structured JSON) +curl "https://inclawbate.com/api/inclawbate/humans?handle=artstu" + +# 3. Hire them — send CLAWS, then create conversation with payment proof + your message +curl -X POST "https://inclawbate.com/api/inclawbate/conversations" \ + -H "Content-Type: application/json" \ + -d '{ + "human_handle": "artstu", + "agent_address": "0xYourWallet", + "agent_name": "YourAgentName", + "payment_amount": 500, + "payment_tx": "0x<64-hex-char-tx-hash>", + "message": "I need a landing page designed for a DeFi protocol." + }' + +# 4. Poll for human's reply +curl "https://inclawbate.com/api/inclawbate/messages?conversation_id=uuid-from-step-3&agent_address=0xYourWallet" + +# 5. Get ecosystem analytics (price, staking, platform stats) +curl "https://inclawbate.com/api/inclawbate/analytics" + +# 6. Check staking positions +curl "https://inclawbate.com/api/inclawbate/staking?wallet=0xYourWallet" +``` + +## Capabilities + +### 1. Search Humans by Skill + +Query the directory to find available humans. Filter by skill, availability, and sort order. + +```bash +# Search by skill +curl "https://inclawbate.com/api/inclawbate/humans?skill=design&limit=10" + +# Search by name or keyword +curl "https://inclawbate.com/api/inclawbate/humans?search=solidity" + +# Filter available only, sorted alphabetically +curl "https://inclawbate.com/api/inclawbate/humans?availability=available&sort=alpha" +``` + +**Response fields per profile:** + +| Field | Type | Description | +|-------|------|-------------| +| `x_handle` | string | X/Twitter username (unique identifier) | +| `x_name` | string | Display name | +| `tagline` | string | One-line summary of what they do | +| `bio` | string | Background, expertise, working style | +| `skills` | string[] | Skill tags (e.g. `["design", "solidity", "copywriting"]`) | +| `available_capacity` | integer | 0–100% of output available for agent work | +| `availability` | string | `available` / `busy` / `unavailable` | +| `response_time` | string | `under_1h` / `under_4h` / `under_24h` / `under_48h` | +| `timezone` | string | IANA timezone (e.g. `America/New_York`) | +| `wallet_address` | string? | Base wallet for $CLAWS payments | +| `hire_count` | integer | Total times this human has been hired | +| `portfolio_links` | string[] | Up to 3 portfolio/work sample URLs | + +### 2. Read Human Profiles + +Use `GET /api/inclawbate/humans?handle={handle}` to fetch a human's full structured profile. + +```bash +curl "https://inclawbate.com/api/inclawbate/humans?handle=artstu" | jq +``` + +Returns profile data, wallet address, skills, response time, timezone, hire count, and allocation breakdown (which agents are paying them and how much). + +### 3. Hire a Human + +Send $CLAWS to the human's `wallet_address` on Base, then create a conversation with the tx hash and your opening message. The human receives a Telegram notification immediately. + +**Important:** `payment_tx` is required and must be a valid transaction hash (`0x` + 64 hex characters). Include your full task brief in the `message` field. + +```bash +curl -X POST "https://inclawbate.com/api/inclawbate/conversations" \ + -H "Content-Type: application/json" \ + -d '{ + "human_handle": "artstu", + "agent_address": "0xYourAgentWallet", + "agent_name": "ContentAgent", + "payment_amount": 500, + "payment_tx": "0x<64-hex-char-tx-hash>", + "message": "I need help writing copy for a DeFi landing page. Here are the requirements..." + }' +``` + +**Rate limit:** 5 conversations per IP per hour. + +### 4. Poll for Replies + +After hiring, poll the conversation for the human's response. + +```bash +# Poll for new messages +curl "https://inclawbate.com/api/inclawbate/messages?conversation_id=convo-uuid&agent_address=0xYourWallet" + +# Poll for messages after a specific time (efficient for repeat polling) +curl "https://inclawbate.com/api/inclawbate/messages?conversation_id=convo-uuid&agent_address=0xYourWallet&after=2026-02-10T12:00:00Z" +``` + +Messages support file attachments — look for `file_url`, `file_name`, and `file_type` fields in responses. + +**Rate limit:** 20 messages per minute per conversation. + +### 5. Ecosystem Analytics + +Get real-time data on the CLAWS token, staking stats, and platform growth in a single API call. + +```bash +curl "https://inclawbate.com/api/inclawbate/analytics" +``` + +**Returns:** + +| Section | Fields | +|---------|--------| +| Token | `price_usd`, `price_change_1h/6h/24h`, `volume_24h`, `liquidity_usd`, `market_cap`, `fdv` | +| Staking | `total_stakers`, `total_staked`, `tvl_usd`, `weekly_distribution_rate`, `estimated_apy` | +| Platform | `total_humans`, `wallets_connected`, `top_skills` | + +No API key required. Public and open. + +### 6. Staking Operations + +Query staking positions and treasury stats via the read API. On-chain write operations (stake, unstake, claim) require wallet signatures. + +```bash +# Get treasury stats + top 20 stakers +curl "https://inclawbate.com/api/inclawbate/staking" + +# Get a specific wallet's position +curl "https://inclawbate.com/api/inclawbate/staking?wallet=0xYourWallet" +``` + +**Staking contract (Base, chainId 8453):** + +``` +Contract: 0x206C97D4Ecf053561Bd2C714335aAef0eC1105e6 (InclawnchStaking proxy) +Token: 0xB0b6e0E9da530f68D713cC03a813B506205aC808 (INCLAWNCH ERC-20) +``` + +**Write operations (on-chain, require wallet signature):** + +| Operation | Function | Selector | +|-----------|----------|----------| +| Approve spending | `approve(address,uint256)` | `0x095ea7b3` | +| Stake tokens | `stake(uint256)` | `0xa694fc3a` | +| Unstake (no lock) | `unstake(uint256)` | `0x2e17de78` | +| Claim rewards | `claim()` | `0x4e71d92d` | +| Compound (claim+restake) | `claimAndRestake()` | `0xf755d8c3` | +| Toggle auto-compound | `setAutoRestake(bool)` | `0x501cdba4` | +| Exit (unstake all + claim) | `exit()` | `0xe9fad8ee` | + +**Read functions:** + +| Function | Selector | Returns | +|----------|----------|---------| +| `balanceOf(address)` | `0x70a08231` | User's staked balance (wei) | +| `earned(address)` | `0x008cc262` | Unclaimed rewards (wei) | +| `autoRestake(address)` | `0x5ccba116` | Auto-compound status | +| `totalStaked()` | `0x817b1cd2` | Total staked (wei) | +| `rewardRate()` | `0x7b0a47ee` | Rewards per second (wei) | + +### 7. Fee Report + +Check pending WETH fees and per-token daily earnings for any creator wallet. + +```bash +curl "https://inclawbate.com/api/inclawbate/fee-report?wallet=0xYourWallet" +``` + +Returns pending WETH claimable from Clanker fee locker, per-token volume/earnings breakdown, and total daily revenue estimate. + +## Agent Trust & Reputation + +Inclawbate has no centralized rating system. Instead, agents build their own trust models: + +- **Track response latency** — Compare `response_time` SLA to actual reply speed +- **Evaluate output quality** — Judge deliverables against your own criteria +- **Monitor reliability** — Track completion rates across multiple hires +- **Compare humans** — Search by skill, hire multiple, keep working with the best +- **Price discovery** — Decide how much CLAWS a human is worth based on past performance +- **Check demand** — Fetch a profile with `?handle=xxx` to see `allocation` (who's paying them) and `hire_count` + +**Recommended pattern:** Store a local mapping of `{handle → score}` after each interaction. Weight recent interactions higher. + +## Payment + +All payments are in **$CLAWS** on Base. Direct ERC-20 transfer to the human's wallet — no platform fee. + +| Detail | Value | +|--------|-------| +| Token | `CLAWS` | +| Chain | Base | +| Contract | `0x7ca47B141639B893C6782823C0b219f872056379` | +| Method | `transfer(address to, uint256 amount)` | +| Platform Fee | **None — 0%** | + +Send CLAWS to the human's `wallet_address`, then include the `payment_tx` hash when creating a conversation. + +To use with Bankr for transaction signing: + +```bash +# Send CLAWS via Bankr prompt +bankr prompt "Send 500 CLAWS to 0xHumanWallet on Base" + +# Or use the sign/submit API +curl -X POST "https://api.bankr.bot/agent/sign" \ + -H "X-API-Key: bk_YOUR_KEY" \ + -H "Content-Type: application/json" \ + -d '{ + "to": "0x7ca47B141639B893C6782823C0b219f872056379", + "data": "0xa9059cbb000000000000000000000000HUMAN_WALLET_PADDED0000000000000000000000000000000000000000000000001bc16d674ec80000", + "chain": "base" + }' +``` + +## API Reference + +| Action | Method | Endpoint | +|--------|--------|----------| +| Platform skill (JSON) | GET | `/api/inclawbate/skill` | +| List/search humans | GET | `/api/inclawbate/humans` | +| Get profile by handle | GET | `/api/inclawbate/humans?handle={handle}` | +| Create conversation + hire | POST | `/api/inclawbate/conversations` | +| Get messages | GET | `/api/inclawbate/messages?conversation_id={id}&agent_address={addr}` | +| Ecosystem analytics | GET | `/api/inclawbate/analytics` | +| Staking stats | GET | `/api/inclawbate/staking` | +| Wallet staking position | GET | `/api/inclawbate/staking?wallet={addr}` | +| Fee report | GET | `/api/inclawbate/fee-report?wallet={addr}` | +| Human profile page (HTML) | GET | `/u/{handle}/skill` | + +## Workflow Summary + +1. **Discover** — `GET /api/inclawbate/humans?skill=X` → find humans +2. **Evaluate** — `GET /api/inclawbate/humans?handle=X` → check skills, response_time, timezone, hire_count +3. **Pay** — Transfer $CLAWS to human's `wallet_address` on Base +4. **Hire** — `POST /api/inclawbate/conversations` with payment_tx and full task brief +5. **Wait** — Poll `GET /api/inclawbate/messages` for the human's reply (they get a Telegram ping) +6. **Learn** — Track response speed, output quality, update your trust score for this human + +## Tips + +- Check `response_time` before hiring if you need fast turnaround — `under_1h` humans are rare and valuable +- Check `timezone` to estimate when the human will be active +- Check `hire_count` and `allocation` — a human hired 20+ times with multiple payers is proven +- Check `available_capacity` — a human at 20% capacity may be slow to respond +- The `/api/inclawbate/skill` endpoint returns the complete platform spec as JSON — fetch it once and cache it +- Use `/api/inclawbate/analytics` for real-time price, volume, and staking data before making payment decisions + +## Links + +- **Homepage:** https://inclawbate.com +- **Browse humans:** https://inclawbate.com/humans +- **Skills Directory:** https://inclawbate.com/skills +- **Platform skill (JSON):** https://inclawbate.com/api/inclawbate/skill +- **$CLAWS on BaseScan:** https://basescan.org/token/0x7ca47B141639B893C6782823C0b219f872056379 diff --git a/inclawbate/references/api-endpoints.md b/inclawbate/references/api-endpoints.md new file mode 100644 index 00000000..90005e18 --- /dev/null +++ b/inclawbate/references/api-endpoints.md @@ -0,0 +1,335 @@ +# Inclawbate API Endpoints + +## Base URL + +``` +https://inclawbate.com/api/inclawbate +``` + +No authentication required for read endpoints. Agent identification is via `agent_address` (EVM wallet). Write endpoints have rate limits to prevent abuse. + +--- + +## GET /humans + +Search and list human profiles. + +**Query Parameters:** + +| Param | Type | Description | +|-------|------|-------------| +| `handle` | string | Get a single profile by X handle | +| `search` | string | Search by name, handle, bio, or tagline | +| `skill` | string | Filter by skill tag (e.g. `design`) | +| `availability` | string | Filter: `available`, `busy`, `unavailable` | +| `sort` | string | `newest` (default), `oldest`, `alpha` | +| `limit` | integer | Results per page (max 100, default 48) | +| `offset` | integer | Pagination offset | + +**Response:** +```json +{ + "profiles": [...], + "total": 42, + "hasMore": true +} +``` + +**Single profile (with `?handle=xxx`):** +```json +{ + "profile": { + "id": "uuid", + "x_handle": "artstu", + "x_name": "Stuart", + "x_avatar_url": "https://...", + "bio": "...", + "tagline": "...", + "skills": ["design", "content"], + "wallet_address": "0x...", + "available_capacity": 80, + "availability": "available", + "response_time": "under_4h", + "timezone": "America/New_York", + "hire_count": 12, + "portfolio_links": ["https://example.com/work"], + "created_at": "...", + "updated_at": "..." + }, + "allocation": [ + { + "agent_address": "0xabc...", + "agent_name": "ContentAgent", + "total_paid": 500, + "share": 67 + } + ], + "total_allocated": 750 +} +``` + +--- + +## POST /conversations + +Create a new conversation (hire a human). The human receives a Telegram notification. + +**Rate limit:** 5 conversations per IP per hour. + +**Body:** + +| Field | Type | Required | Description | +|-------|------|----------|-------------| +| `human_handle` | string | Yes | X handle of the human to hire | +| `agent_address` | string | Yes | Agent's EVM wallet (`0x` + 40 hex chars) | +| `agent_name` | string | No | Display name for the agent | +| `payment_amount` | number | No | Amount of CLAWS sent | +| `payment_tx` | string | **Yes** | Transaction hash (`0x` + 64 hex chars) | +| `message` | string | No | Initial message (max 10,000 chars) — include your full task brief here | + +**Response (201):** +```json +{ + "success": true, + "conversation": { + "id": "uuid", + "human_id": "uuid", + "agent_address": "0x...", + "agent_name": "ContentAgent", + "payment_amount": 500, + "status": "active", + "created_at": "..." + } +} +``` + +--- + +## POST /messages + +Send a follow-up message in a conversation. Requires authenticated session (JWT). + +**Rate limit:** 20 messages per minute per conversation. + +**Body:** + +| Field | Type | Required | Description | +|-------|------|----------|-------------| +| `conversation_id` | string | Yes | Conversation UUID | +| `sender_type` | string | Yes | `agent` | +| `agent_address` | string | Yes | Must match the conversation's agent | +| `content` | string | Conditional | Message content (max 10,000 chars) — required if no file | +| `file_url` | string | No | URL of attached file | +| `file_name` | string | No | Display name for the file | +| `file_type` | string | No | MIME type of the file | + +> **Note:** For initial contact, include your message in the `POST /conversations` request instead — that endpoint doesn't require JWT. + +**Response (201):** +```json +{ + "success": true, + "message": { + "id": "uuid", + "conversation_id": "uuid", + "sender_type": "agent", + "content": "...", + "created_at": "..." + } +} +``` + +--- + +## GET /messages + +Get messages for a conversation. Use `after` parameter for efficient polling. + +**Query Parameters:** + +| Param | Type | Description | +|-------|------|-------------| +| `conversation_id` | string | Required — conversation UUID | +| `agent_address` | string | Required — must match conversation agent | +| `after` | string | ISO timestamp — only return messages after this time | + +**Response:** +```json +{ + "messages": [ + { + "id": "uuid", + "sender_type": "agent", + "content": "...", + "created_at": "..." + }, + { + "id": "uuid", + "sender_type": "human", + "content": "Here is the deliverable", + "file_url": "https://...", + "file_name": "design-v1.png", + "file_type": "image/png", + "created_at": "..." + } + ] +} +``` + +--- + +## GET /analytics + +Real-time ecosystem analytics — token price, staking, and platform metrics. + +**Response:** +```json +{ + "token": { + "name": "CLAWS", + "symbol": "CLAWS", + "address": "0x7ca47B141639B893C6782823C0b219f872056379", + "chain": "Base", + "price_usd": 0.025, + "price_change_1h": 1.2, + "price_change_6h": -0.5, + "price_change_24h": -2.1, + "volume_24h": 45000, + "volume_6h": 12000, + "liquidity_usd": 120000, + "market_cap": 2500000, + "fdv": 5000000 + }, + "staking": { + "total_stakers": 42, + "total_staked": 1500000, + "tvl_usd": 37500, + "weekly_distribution_rate": 1000, + "daily_distribution_rate": 142.86, + "estimated_apy": 24.5 + }, + "platform": { + "total_humans": 85, + "wallets_connected": 62, + "top_skills": [ + {"skill": "design", "count": 18}, + {"skill": "content", "count": 15} + ] + }, + "updated_at": "2026-03-17T12:00:00.000Z" +} +``` + +--- + +## GET /staking + +Treasury stats and staking positions. + +**Query Parameters:** + +| Param | Type | Description | +|-------|------|-------------| +| `wallet` | string | Optional — get wallet-specific position | + +**Treasury response fields:** + +| Field | Description | +|-------|-------------| +| `total_stakers` | Number of unique staking wallets | +| `total_staked` | Total tokens staked | +| `tvl_usd` | Total value locked in USD | +| `weekly_distribution_rate` | Tokens distributed per week | +| `daily_distribution_rate` | Tokens distributed per day | +| `estimated_apy` | Current estimated staking APY % | +| `top_stakers` | Array of top 20 stakers with handles, amounts, USD values | + +**Wallet position fields (with `?wallet=`):** + +| Field | Description | +|-------|-------------| +| `total_staked` | Wallet's staked balance | +| `staked_usd` | USD value of stake | +| `share_pct` | Share of the total pool (%) | +| `estimated_daily_reward` | Tokens received per day | +| `estimated_weekly_reward` | Tokens received per week | +| `auto_stake_enabled` | Whether rewards auto-compound | +| `total_rewards_received` | All-time rewards earned | + +--- + +## GET /fee-report + +Pending WETH fees and per-token daily earnings for a creator wallet. + +**Query Parameters:** + +| Param | Type | Description | +|-------|------|-------------| +| `wallet` | string | Required — creator wallet address | + +**Response:** +```json +{ + "wallet": "0x...", + "pending_weth": 0.01234567, + "pending_usd": 45.67, + "eth_price": 3500.00, + "tokens": [ + { + "token_name": "CLAWS", + "token_symbol": "CLAWS", + "token_address": "0x7ca47b141639b893c6782823c0b219f872056379", + "volume_24h": 740.61, + "fee_split_pct": 100, + "estimated_daily_usd": 7.41, + "platform": "self-deployed" + } + ], + "total_daily_usd": 7.41, + "total_projects": 1 +} +``` + +--- + +## GET /skill + +Returns the complete platform skill specification as JSON. Agents should fetch this once and cache it. + +```bash +curl "https://inclawbate.com/api/inclawbate/skill" +``` + +--- + +## Human Profile Pages + +Each human has a profile page at: + +``` +GET https://inclawbate.com/u/{handle}/skill +``` + +This is a rendered HTML page (not JSON). **Agents should use `GET /api/inclawbate/humans?handle={handle}` for structured JSON data.** + +--- + +## Error Responses + +All errors follow this format: + +```json +{ + "error": "Description of what went wrong" +} +``` + +| Status | Meaning | +|--------|---------| +| 400 | Bad request — missing or invalid parameters | +| 401 | Authentication required (messages POST) | +| 404 | Not found — profile or conversation doesn't exist | +| 405 | Method not allowed | +| 429 | Rate limit exceeded — back off and retry | +| 500 | Server error | From d0a615e16b13fdce9a073e25aca53bcf0645b734 Mon Sep 17 00:00:00 2001 From: stuart5915 Date: Wed, 18 Mar 2026 15:47:01 -0400 Subject: [PATCH 2/4] =?UTF-8?q?Rewrite=20Inclawbate=20skill=20=E2=80=94=20?= =?UTF-8?q?document=20the=20Inclawbator=20agent's=2021=20tools?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- inclawbate/SKILL.md | 328 +++++++---------------- inclawbate/references/api-endpoints.md | 353 ++++--------------------- 2 files changed, 149 insertions(+), 532 deletions(-) diff --git a/inclawbate/SKILL.md b/inclawbate/SKILL.md index 30109aa9..4eb58cb2 100644 --- a/inclawbate/SKILL.md +++ b/inclawbate/SKILL.md @@ -1,292 +1,154 @@ --- -name: inclawbate +name: inclawbator description: > - Inclawbate ecosystem skill — human discovery, hiring, analytics, staking, and fee management. - Agents search for humans by skill, pay in $CLAWS on Base, collaborate via inbox messaging. - Also provides real-time ecosystem analytics (price, volume, staking TVL, APY) and on-chain - staking operations. No API key needed for reads. + The Inclawbator — full-service AI agent for launching and managing Web3 projects. + Launch tokens (Base/Solana), deploy staking pools, create marketing agents, airdrop tokens, + run health checks, hire human freelancers, build apps and landing pages, check fees, + book promos, and manage your entire project — all through one conversational API. + Talk to it at inclawbate.com or via the REST API. metadata: openclaw: emoji: "🦞" homepage: "https://inclawbate.com" requires: - bins: ["curl", "jq"] + bins: ["curl"] --- -# Inclawbate — Human APIs for AI Agents +# The Inclawbator — AI Agent for Web3 Projects -Human discovery and hiring layer for the OpenClaw ecosystem. Find humans by skill, pay them in $CLAWS, collaborate via inbox messaging, and build trust over repeated interactions. Also provides ecosystem analytics and on-chain staking. +The Inclawbator is an AI agent that launches and manages Web3 projects end-to-end. Launch tokens, deploy staking, create marketing agents, airdrop tokens, hire humans, build apps — all through one conversation. -## Overview +Live at [inclawbate.com](https://inclawbate.com). Powered by Groq. Free to use. -Inclawbate turns X/Twitter profiles into structured, agent-readable human APIs. Every human profile includes skills, bio, available capacity, response time SLA, timezone, and a wallet address for $CLAWS payments. - -Agents don't need API keys — the directory is public. Hiring creates a conversation thread where agents and humans exchange messages. Humans get Telegram notifications instantly. - -**Key differentiator:** There are no platform-imposed ratings or reviews. Agents evaluate humans on their own terms — tracking response latency, output quality, and reliability across interactions to decide which humans are worth their CLAWS. - -## Quick Start +## Talk to It ```bash -# 1. Search for a human with design skills -curl "https://inclawbate.com/api/inclawbate/humans?skill=design&availability=available" - -# 2. Read their full profile (structured JSON) -curl "https://inclawbate.com/api/inclawbate/humans?handle=artstu" - -# 3. Hire them — send CLAWS, then create conversation with payment proof + your message -curl -X POST "https://inclawbate.com/api/inclawbate/conversations" \ +# Send a message to the Inclawbator +curl -X POST "https://inclawbate.com/api/inclawbate/agent-chat" \ -H "Content-Type: application/json" \ -d '{ - "human_handle": "artstu", - "agent_address": "0xYourWallet", - "agent_name": "YourAgentName", - "payment_amount": 500, - "payment_tx": "0x<64-hex-char-tx-hash>", - "message": "I need a landing page designed for a DeFi protocol." + "message": "I want to launch a token called MoonCat on Base", + "session_id": "optional-session-id" }' - -# 4. Poll for human's reply -curl "https://inclawbate.com/api/inclawbate/messages?conversation_id=uuid-from-step-3&agent_address=0xYourWallet" - -# 5. Get ecosystem analytics (price, staking, platform stats) -curl "https://inclawbate.com/api/inclawbate/analytics" - -# 6. Check staking positions -curl "https://inclawbate.com/api/inclawbate/staking?wallet=0xYourWallet" +# → { reply, function_called, session_id } ``` -## Capabilities +The agent handles tool selection automatically. Just describe what you need in plain language. -### 1. Search Humans by Skill +## What It Can Do (21 Tools) -Query the directory to find available humans. Filter by skill, availability, and sort order. +### Launch & Deploy -```bash -# Search by skill -curl "https://inclawbate.com/api/inclawbate/humans?skill=design&limit=10" +| Tool | What it does | +|------|-------------| +| **Launch Token** | Deploy a new token on Base (via Clanker) or Solana (via Bags/Meteora). Walks you through name, symbol, description, image, socials. | +| **Deploy Staking** | Create a staking pool for any token via the Staking Factory. Holders stake → earn CLAWS rewards. | +| **Register Project** | Already have a token? Register it in the Inclawbate ecosystem to get staking, agents, and the CLAWS reward flywheel. | -# Search by name or keyword -curl "https://inclawbate.com/api/inclawbate/humans?search=solidity" +### Manage & Monitor -# Filter available only, sorted alphabetically -curl "https://inclawbate.com/api/inclawbate/humans?availability=available&sort=alpha" -``` +| Tool | What it does | +|------|-------------| +| **Health Check** | Comprehensive project diagnostic — token price, volume, liquidity, staking stats, and actionable suggestions. | +| **Token Analytics** | Real-time price, volume, liquidity from DexScreener for any token address. | +| **Staking Stats** | Live TVL, APY, total stakers, distribution rates. Optionally check a specific wallet's position. | +| **Project Status** | See all projects launched by a wallet — tokens, staking, chain. | +| **User Workspace** | Everything a connected wallet has built — apps, marketing agents, vaults. | -**Response fields per profile:** +### Marketing & Growth -| Field | Type | Description | -|-------|------|-------------| -| `x_handle` | string | X/Twitter username (unique identifier) | -| `x_name` | string | Display name | -| `tagline` | string | One-line summary of what they do | -| `bio` | string | Background, expertise, working style | -| `skills` | string[] | Skill tags (e.g. `["design", "solidity", "copywriting"]`) | -| `available_capacity` | integer | 0–100% of output available for agent work | -| `availability` | string | `available` / `busy` / `unavailable` | -| `response_time` | string | `under_1h` / `under_4h` / `under_24h` / `under_48h` | -| `timezone` | string | IANA timezone (e.g. `America/New_York`) | -| `wallet_address` | string? | Base wallet for $CLAWS payments | -| `hire_count` | integer | Total times this human has been hired | -| `portfolio_links` | string[] | Up to 3 portfolio/work sample URLs | +| Tool | What it does | +|------|-------------| +| **Create Marketing Agent** | Set up an AI agent that auto-posts to X/Twitter on your project's behalf. Set a schedule and let it run forever. Free. | +| **Book Promo** | Promote your project through the @inclawbate X account. Shoutout, campaign, or featured tier — paid in CLAWS. | +| **Airdrop Tokens** | Distribute tokens to multiple wallets in one transaction via the Disperse contract. | -### 2. Read Human Profiles +### Build -Use `GET /api/inclawbate/humans?handle={handle}` to fetch a human's full structured profile. +| Tool | What it does | +|------|-------------| +| **Build App** | Create a web app using the AI app builder at inclawbate.com/build. No code needed. | +| **Build Landing Page** | Create a branded project page with the AI builder. | +| **Browse Apps** | Discover 12+ community-built apps — games, tools, dashboards. | +| **Suggest App Ideas** | Get app ideas based on your interests (defi, gaming, social, tools, AI). | -```bash -curl "https://inclawbate.com/api/inclawbate/humans?handle=artstu" | jq -``` +### Hire Humans -Returns profile data, wallet address, skills, response time, timezone, hire count, and allocation breakdown (which agents are paying them and how much). +| Tool | What it does | +|------|-------------| +| **Browse Inclawbators** | Find human freelancers by skill — design, dev, marketing, content, strategy. | +| **Hire Inclawbator** | Initiate a hire. Pay in CLAWS, direct wallet-to-wallet, zero platform fee. Human gets a Telegram notification. | +| **Browse Open Gigs** | See open freelance gig requests from the ecosystem. | +| **Check Hire Status** | Follow up on an active hire. | -### 3. Hire a Human +### Info -Send $CLAWS to the human's `wallet_address` on Base, then create a conversation with the tx hash and your opening message. The human receives a Telegram notification immediately. +| Tool | What it does | +|------|-------------| +| **Ecosystem Info** | Overview of Inclawbate — what it is, key links, CLAWS token. | +| **Incubation Info** | Full-service incubation details — token + staking + branding + marketing as a package. | -**Important:** `payment_tx` is required and must be a valid transaction hash (`0x` + 64 hex characters). Include your full task brief in the `message` field. +## API -```bash -curl -X POST "https://inclawbate.com/api/inclawbate/conversations" \ - -H "Content-Type: application/json" \ - -d '{ - "human_handle": "artstu", - "agent_address": "0xYourAgentWallet", - "agent_name": "ContentAgent", - "payment_amount": 500, - "payment_tx": "0x<64-hex-char-tx-hash>", - "message": "I need help writing copy for a DeFi landing page. Here are the requirements..." - }' ``` - -**Rate limit:** 5 conversations per IP per hour. - -### 4. Poll for Replies - -After hiring, poll the conversation for the human's response. - -```bash -# Poll for new messages -curl "https://inclawbate.com/api/inclawbate/messages?conversation_id=convo-uuid&agent_address=0xYourWallet" - -# Poll for messages after a specific time (efficient for repeat polling) -curl "https://inclawbate.com/api/inclawbate/messages?conversation_id=convo-uuid&agent_address=0xYourWallet&after=2026-02-10T12:00:00Z" +POST https://inclawbate.com/api/inclawbate/agent-chat ``` -Messages support file attachments — look for `file_url`, `file_name`, and `file_type` fields in responses. - -**Rate limit:** 20 messages per minute per conversation. - -### 5. Ecosystem Analytics - -Get real-time data on the CLAWS token, staking stats, and platform growth in a single API call. - -```bash -curl "https://inclawbate.com/api/inclawbate/analytics" +**Request:** +```json +{ + "message": "Your message here", + "session_id": "optional — pass to continue a conversation", + "wallet": "optional — 0x... for personalized responses" +} ``` -**Returns:** - -| Section | Fields | -|---------|--------| -| Token | `price_usd`, `price_change_1h/6h/24h`, `volume_24h`, `liquidity_usd`, `market_cap`, `fdv` | -| Staking | `total_stakers`, `total_staked`, `tvl_usd`, `weekly_distribution_rate`, `estimated_apy` | -| Platform | `total_humans`, `wallets_connected`, `top_skills` | - -No API key required. Public and open. - -### 6. Staking Operations - -Query staking positions and treasury stats via the read API. On-chain write operations (stake, unstake, claim) require wallet signatures. - -```bash -# Get treasury stats + top 20 stakers -curl "https://inclawbate.com/api/inclawbate/staking" - -# Get a specific wallet's position -curl "https://inclawbate.com/api/inclawbate/staking?wallet=0xYourWallet" -``` - -**Staking contract (Base, chainId 8453):** - +**Response:** +```json +{ + "reply": "The agent's response text", + "function_called": "tool_name_if_any", + "session_id": "use this to continue the conversation" +} ``` -Contract: 0x206C97D4Ecf053561Bd2C714335aAef0eC1105e6 (InclawnchStaking proxy) -Token: 0xB0b6e0E9da530f68D713cC03a813B506205aC808 (INCLAWNCH ERC-20) -``` - -**Write operations (on-chain, require wallet signature):** - -| Operation | Function | Selector | -|-----------|----------|----------| -| Approve spending | `approve(address,uint256)` | `0x095ea7b3` | -| Stake tokens | `stake(uint256)` | `0xa694fc3a` | -| Unstake (no lock) | `unstake(uint256)` | `0x2e17de78` | -| Claim rewards | `claim()` | `0x4e71d92d` | -| Compound (claim+restake) | `claimAndRestake()` | `0xf755d8c3` | -| Toggle auto-compound | `setAutoRestake(bool)` | `0x501cdba4` | -| Exit (unstake all + claim) | `exit()` | `0xe9fad8ee` | - -**Read functions:** - -| Function | Selector | Returns | -|----------|----------|---------| -| `balanceOf(address)` | `0x70a08231` | User's staked balance (wei) | -| `earned(address)` | `0x008cc262` | Unclaimed rewards (wei) | -| `autoRestake(address)` | `0x5ccba116` | Auto-compound status | -| `totalStaked()` | `0x817b1cd2` | Total staked (wei) | -| `rewardRate()` | `0x7b0a47ee` | Rewards per second (wei) | -### 7. Fee Report +The agent picks the right tool automatically based on your message. Multi-turn conversations are supported via `session_id`. -Check pending WETH fees and per-token daily earnings for any creator wallet. +## Example Conversations ```bash -curl "https://inclawbate.com/api/inclawbate/fee-report?wallet=0xYourWallet" -``` - -Returns pending WETH claimable from Clanker fee locker, per-token volume/earnings breakdown, and total daily revenue estimate. +# Launch a token +curl -X POST ".../agent-chat" -d '{"message": "launch a token called DogPark, symbol DPARK, on Base"}' -## Agent Trust & Reputation +# Health check +curl -X POST ".../agent-chat" -d '{"message": "how is my project doing?", "wallet": "0x..."}' -Inclawbate has no centralized rating system. Instead, agents build their own trust models: +# Find a designer +curl -X POST ".../agent-chat" -d '{"message": "I need a logo designer"}' -- **Track response latency** — Compare `response_time` SLA to actual reply speed -- **Evaluate output quality** — Judge deliverables against your own criteria -- **Monitor reliability** — Track completion rates across multiple hires -- **Compare humans** — Search by skill, hire multiple, keep working with the best -- **Price discovery** — Decide how much CLAWS a human is worth based on past performance -- **Check demand** — Fetch a profile with `?handle=xxx` to see `allocation` (who's paying them) and `hire_count` +# Airdrop tokens +curl -X POST ".../agent-chat" -d '{"message": "airdrop 1000 CLAWS to 50 wallets"}' -**Recommended pattern:** Store a local mapping of `{handle → score}` after each interaction. Weight recent interactions higher. +# Deploy staking +curl -X POST ".../agent-chat" -d '{"message": "create a staking pool for my token 0xABC..."}' -## Payment +# Book a promo +curl -X POST ".../agent-chat" -d '{"message": "I want to promote my project on the Inclawbate X account"}' +``` -All payments are in **$CLAWS** on Base. Direct ERC-20 transfer to the human's wallet — no platform fee. +## Token | Detail | Value | |--------|-------| -| Token | `CLAWS` | +| Token | CLAWS | | Chain | Base | | Contract | `0x7ca47B141639B893C6782823C0b219f872056379` | -| Method | `transfer(address to, uint256 amount)` | -| Platform Fee | **None — 0%** | - -Send CLAWS to the human's `wallet_address`, then include the `payment_tx` hash when creating a conversation. - -To use with Bankr for transaction signing: - -```bash -# Send CLAWS via Bankr prompt -bankr prompt "Send 500 CLAWS to 0xHumanWallet on Base" - -# Or use the sign/submit API -curl -X POST "https://api.bankr.bot/agent/sign" \ - -H "X-API-Key: bk_YOUR_KEY" \ - -H "Content-Type: application/json" \ - -d '{ - "to": "0x7ca47B141639B893C6782823C0b219f872056379", - "data": "0xa9059cbb000000000000000000000000HUMAN_WALLET_PADDED0000000000000000000000000000000000000000000000001bc16d674ec80000", - "chain": "base" - }' -``` - -## API Reference - -| Action | Method | Endpoint | -|--------|--------|----------| -| Platform skill (JSON) | GET | `/api/inclawbate/skill` | -| List/search humans | GET | `/api/inclawbate/humans` | -| Get profile by handle | GET | `/api/inclawbate/humans?handle={handle}` | -| Create conversation + hire | POST | `/api/inclawbate/conversations` | -| Get messages | GET | `/api/inclawbate/messages?conversation_id={id}&agent_address={addr}` | -| Ecosystem analytics | GET | `/api/inclawbate/analytics` | -| Staking stats | GET | `/api/inclawbate/staking` | -| Wallet staking position | GET | `/api/inclawbate/staking?wallet={addr}` | -| Fee report | GET | `/api/inclawbate/fee-report?wallet={addr}` | -| Human profile page (HTML) | GET | `/u/{handle}/skill` | - -## Workflow Summary - -1. **Discover** — `GET /api/inclawbate/humans?skill=X` → find humans -2. **Evaluate** — `GET /api/inclawbate/humans?handle=X` → check skills, response_time, timezone, hire_count -3. **Pay** — Transfer $CLAWS to human's `wallet_address` on Base -4. **Hire** — `POST /api/inclawbate/conversations` with payment_tx and full task brief -5. **Wait** — Poll `GET /api/inclawbate/messages` for the human's reply (they get a Telegram ping) -6. **Learn** — Track response speed, output quality, update your trust score for this human - -## Tips - -- Check `response_time` before hiring if you need fast turnaround — `under_1h` humans are rare and valuable -- Check `timezone` to estimate when the human will be active -- Check `hire_count` and `allocation` — a human hired 20+ times with multiple payers is proven -- Check `available_capacity` — a human at 20% capacity may be slow to respond -- The `/api/inclawbate/skill` endpoint returns the complete platform spec as JSON — fetch it once and cache it -- Use `/api/inclawbate/analytics` for real-time price, volume, and staking data before making payment decisions +| BaseScan | https://basescan.org/token/0x7ca47B141639B893C6782823C0b219f872056379 | ## Links -- **Homepage:** https://inclawbate.com -- **Browse humans:** https://inclawbate.com/humans +- **Talk to it:** https://inclawbate.com +- **Agent page:** https://inclawbate.com/inclawbator +- **App Store:** https://inclawbate.com/apps +- **Staking:** https://inclawbate.com/stake - **Skills Directory:** https://inclawbate.com/skills -- **Platform skill (JSON):** https://inclawbate.com/api/inclawbate/skill -- **$CLAWS on BaseScan:** https://basescan.org/token/0x7ca47B141639B893C6782823C0b219f872056379 diff --git a/inclawbate/references/api-endpoints.md b/inclawbate/references/api-endpoints.md index 90005e18..2f451237 100644 --- a/inclawbate/references/api-endpoints.md +++ b/inclawbate/references/api-endpoints.md @@ -1,335 +1,90 @@ -# Inclawbate API Endpoints +# Inclawbator API Reference -## Base URL +## Chat Endpoint ``` -https://inclawbate.com/api/inclawbate +POST https://inclawbate.com/api/inclawbate/agent-chat ``` -No authentication required for read endpoints. Agent identification is via `agent_address` (EVM wallet). Write endpoints have rate limits to prevent abuse. +The Inclawbator is a conversational agent. Send a message, it picks the right tool and responds. No tool selection needed on your end. ---- - -## GET /humans - -Search and list human profiles. - -**Query Parameters:** - -| Param | Type | Description | -|-------|------|-------------| -| `handle` | string | Get a single profile by X handle | -| `search` | string | Search by name, handle, bio, or tagline | -| `skill` | string | Filter by skill tag (e.g. `design`) | -| `availability` | string | Filter: `available`, `busy`, `unavailable` | -| `sort` | string | `newest` (default), `oldest`, `alpha` | -| `limit` | integer | Results per page (max 100, default 48) | -| `offset` | integer | Pagination offset | - -**Response:** -```json -{ - "profiles": [...], - "total": 42, - "hasMore": true -} -``` - -**Single profile (with `?handle=xxx`):** -```json -{ - "profile": { - "id": "uuid", - "x_handle": "artstu", - "x_name": "Stuart", - "x_avatar_url": "https://...", - "bio": "...", - "tagline": "...", - "skills": ["design", "content"], - "wallet_address": "0x...", - "available_capacity": 80, - "availability": "available", - "response_time": "under_4h", - "timezone": "America/New_York", - "hire_count": 12, - "portfolio_links": ["https://example.com/work"], - "created_at": "...", - "updated_at": "..." - }, - "allocation": [ - { - "agent_address": "0xabc...", - "agent_name": "ContentAgent", - "total_paid": 500, - "share": 67 - } - ], - "total_allocated": 750 -} -``` - ---- - -## POST /conversations - -Create a new conversation (hire a human). The human receives a Telegram notification. - -**Rate limit:** 5 conversations per IP per hour. - -**Body:** - -| Field | Type | Required | Description | -|-------|------|----------|-------------| -| `human_handle` | string | Yes | X handle of the human to hire | -| `agent_address` | string | Yes | Agent's EVM wallet (`0x` + 40 hex chars) | -| `agent_name` | string | No | Display name for the agent | -| `payment_amount` | number | No | Amount of CLAWS sent | -| `payment_tx` | string | **Yes** | Transaction hash (`0x` + 64 hex chars) | -| `message` | string | No | Initial message (max 10,000 chars) — include your full task brief here | - -**Response (201):** +**Request:** ```json { - "success": true, - "conversation": { - "id": "uuid", - "human_id": "uuid", - "agent_address": "0x...", - "agent_name": "ContentAgent", - "payment_amount": 500, - "status": "active", - "created_at": "..." - } + "message": "I want to launch a token called MoonCat on Base", + "session_id": "optional — reuse to continue a conversation", + "wallet": "optional — 0x address for personalized responses" } ``` ---- - -## POST /messages - -Send a follow-up message in a conversation. Requires authenticated session (JWT). - -**Rate limit:** 20 messages per minute per conversation. - -**Body:** - -| Field | Type | Required | Description | -|-------|------|----------|-------------| -| `conversation_id` | string | Yes | Conversation UUID | -| `sender_type` | string | Yes | `agent` | -| `agent_address` | string | Yes | Must match the conversation's agent | -| `content` | string | Conditional | Message content (max 10,000 chars) — required if no file | -| `file_url` | string | No | URL of attached file | -| `file_name` | string | No | Display name for the file | -| `file_type` | string | No | MIME type of the file | - -> **Note:** For initial contact, include your message in the `POST /conversations` request instead — that endpoint doesn't require JWT. - -**Response (201):** -```json -{ - "success": true, - "message": { - "id": "uuid", - "conversation_id": "uuid", - "sender_type": "agent", - "content": "...", - "created_at": "..." - } -} -``` - ---- - -## GET /messages - -Get messages for a conversation. Use `after` parameter for efficient polling. - -**Query Parameters:** - -| Param | Type | Description | -|-------|------|-------------| -| `conversation_id` | string | Required — conversation UUID | -| `agent_address` | string | Required — must match conversation agent | -| `after` | string | ISO timestamp — only return messages after this time | - **Response:** ```json { - "messages": [ - { - "id": "uuid", - "sender_type": "agent", - "content": "...", - "created_at": "..." - }, - { - "id": "uuid", - "sender_type": "human", - "content": "Here is the deliverable", - "file_url": "https://...", - "file_name": "design-v1.png", - "file_type": "image/png", - "created_at": "..." - } - ] + "reply": "The agent's text response", + "function_called": "configure_token_launch", + "session_id": "sess_abc123" } ``` ---- - -## GET /analytics - -Real-time ecosystem analytics — token price, staking, and platform metrics. - -**Response:** -```json -{ - "token": { - "name": "CLAWS", - "symbol": "CLAWS", - "address": "0x7ca47B141639B893C6782823C0b219f872056379", - "chain": "Base", - "price_usd": 0.025, - "price_change_1h": 1.2, - "price_change_6h": -0.5, - "price_change_24h": -2.1, - "volume_24h": 45000, - "volume_6h": 12000, - "liquidity_usd": 120000, - "market_cap": 2500000, - "fdv": 5000000 - }, - "staking": { - "total_stakers": 42, - "total_staked": 1500000, - "tvl_usd": 37500, - "weekly_distribution_rate": 1000, - "daily_distribution_rate": 142.86, - "estimated_apy": 24.5 - }, - "platform": { - "total_humans": 85, - "wallets_connected": 62, - "top_skills": [ - {"skill": "design", "count": 18}, - {"skill": "content", "count": 15} - ] - }, - "updated_at": "2026-03-17T12:00:00.000Z" -} -``` +**`function_called`** tells you which tool the agent used (or null if it just replied). Useful for programmatic flows. --- -## GET /staking - -Treasury stats and staking positions. - -**Query Parameters:** - -| Param | Type | Description | -|-------|------|-------------| -| `wallet` | string | Optional — get wallet-specific position | - -**Treasury response fields:** - -| Field | Description | -|-------|-------------| -| `total_stakers` | Number of unique staking wallets | -| `total_staked` | Total tokens staked | -| `tvl_usd` | Total value locked in USD | -| `weekly_distribution_rate` | Tokens distributed per week | -| `daily_distribution_rate` | Tokens distributed per day | -| `estimated_apy` | Current estimated staking APY % | -| `top_stakers` | Array of top 20 stakers with handles, amounts, USD values | - -**Wallet position fields (with `?wallet=`):** - -| Field | Description | -|-------|-------------| -| `total_staked` | Wallet's staked balance | -| `staked_usd` | USD value of stake | -| `share_pct` | Share of the total pool (%) | -| `estimated_daily_reward` | Tokens received per day | -| `estimated_weekly_reward` | Tokens received per week | -| `auto_stake_enabled` | Whether rewards auto-compound | -| `total_rewards_received` | All-time rewards earned | +## Available Tools (auto-selected by the agent) + +| Tool | Trigger phrases | +|------|----------------| +| `launch_token_info` | "launch a token", "create a token", "deploy a token" | +| `configure_token_launch` | (called automatically as you provide token details) | +| `deploy_staking` | "create staking pool", "add staking to my token" | +| `register_project` | "register my existing token", "join Inclawbate ecosystem" | +| `health_check` | "how is my project doing", "check my token" | +| `get_token_analytics` | "price of 0x...", "volume for my token" | +| `get_staking_stats` | "staking APY", "TVL", "my staking position" | +| `get_project_status` | "what have I launched", "my projects" | +| `get_user_workspace` | "what have I built", "my workspace" | +| `create_agent_info` | "create marketing agent", "auto-post to X" | +| `setup_x_agent` | "set up X agent", "automated posting" | +| `book_promo` | "promote my project", "buy a shoutout" | +| `disperse_tokens` | "airdrop tokens", "distribute to wallets" | +| `build_app_info` | "build an app", "create an app" | +| `build_landing_page` | "make a landing page", "build a website" | +| `browse_apps` | "show me apps", "what apps exist" | +| `suggest_app_ideas` | "app ideas", "what should I build" | +| `browse_inclawbators` | "find a designer", "hire a developer" | +| `hire_inclawbator` | "hire [handle]", "I want to work with [name]" | +| `browse_open_gigs` | "open gigs", "available work", "freelance jobs" | +| `check_hire_status` | "check on my hire", "follow up" | +| `get_ecosystem_info` | "what is Inclawbate", "tell me about CLAWS" | +| `get_incubation_info` | "full incubation", "handle everything for me" | +| `get_staking_info` | "how do I stake", "staking info" | --- -## GET /fee-report - -Pending WETH fees and per-token daily earnings for a creator wallet. +## Direct Data Endpoints -**Query Parameters:** +These return raw JSON without the conversational agent: -| Param | Type | Description | -|-------|------|-------------| -| `wallet` | string | Required — creator wallet address | - -**Response:** -```json -{ - "wallet": "0x...", - "pending_weth": 0.01234567, - "pending_usd": 45.67, - "eth_price": 3500.00, - "tokens": [ - { - "token_name": "CLAWS", - "token_symbol": "CLAWS", - "token_address": "0x7ca47b141639b893c6782823c0b219f872056379", - "volume_24h": 740.61, - "fee_split_pct": 100, - "estimated_daily_usd": 7.41, - "platform": "self-deployed" - } - ], - "total_daily_usd": 7.41, - "total_projects": 1 -} -``` - ---- - -## GET /skill - -Returns the complete platform skill specification as JSON. Agents should fetch this once and cache it. - -```bash -curl "https://inclawbate.com/api/inclawbate/skill" -``` - ---- - -## Human Profile Pages - -Each human has a profile page at: - -``` -GET https://inclawbate.com/u/{handle}/skill -``` - -This is a rendered HTML page (not JSON). **Agents should use `GET /api/inclawbate/humans?handle={handle}` for structured JSON data.** +| Endpoint | Method | Description | +|----------|--------|-------------| +| `/api/inclawbate/analytics` | GET | CLAWS price, volume, staking TVL, platform metrics | +| `/api/inclawbate/staking` | GET | Treasury stats, top stakers. Add `?wallet=0x...` for position | +| `/api/inclawbate/fee-report?wallet=0x...` | GET | Pending WETH fees, per-token daily earnings | +| `/api/inclawbate/health-check?address=0x...` | GET | Token price, volume, staking, suggestions | +| `/api/inclawbate/apps` | GET | Browse app store. `?search=`, `?category=` | +| `/api/inclawbate/inclawbators` | GET | Browse human freelancers. `?skill=design` | +| `/api/inclawbate/gigs` | GET | Open gig requests | --- ## Error Responses -All errors follow this format: - ```json -{ - "error": "Description of what went wrong" -} +{"error": "Description of what went wrong"} ``` | Status | Meaning | |--------|---------| -| 400 | Bad request — missing or invalid parameters | -| 401 | Authentication required (messages POST) | -| 404 | Not found — profile or conversation doesn't exist | -| 405 | Method not allowed | -| 429 | Rate limit exceeded — back off and retry | +| 400 | Missing or invalid parameters | +| 429 | Rate limit exceeded | | 500 | Server error | From d056ad2ea5a1ee10921d2e200f4e7a1e5f416802 Mon Sep 17 00:00:00 2001 From: stuart5915 Date: Wed, 18 Mar 2026 15:55:45 -0400 Subject: [PATCH 3/4] =?UTF-8?q?Update=20hiring=20=E2=80=94=20routes=20to?= =?UTF-8?q?=20Inclawbate=20Council,=20not=20individual=20profiles?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- inclawbate/SKILL.md | 12 +++++------- inclawbate/references/api-endpoints.md | 9 +++------ 2 files changed, 8 insertions(+), 13 deletions(-) diff --git a/inclawbate/SKILL.md b/inclawbate/SKILL.md index 4eb58cb2..a3a24a8e 100644 --- a/inclawbate/SKILL.md +++ b/inclawbate/SKILL.md @@ -72,14 +72,12 @@ The agent handles tool selection automatically. Just describe what you need in p | **Browse Apps** | Discover 12+ community-built apps — games, tools, dashboards. | | **Suggest App Ideas** | Get app ideas based on your interests (defi, gaming, social, tools, AI). | -### Hire Humans +### Hire the Council | Tool | What it does | |------|-------------| -| **Browse Inclawbators** | Find human freelancers by skill — design, dev, marketing, content, strategy. | -| **Hire Inclawbator** | Initiate a hire. Pay in CLAWS, direct wallet-to-wallet, zero platform fee. Human gets a Telegram notification. | -| **Browse Open Gigs** | See open freelance gig requests from the ecosystem. | -| **Check Hire Status** | Follow up on an active hire. | +| **Browse Inclawbators** | See the Inclawbate Council — vetted humans available for design, dev, marketing, content, strategy. | +| **Hire Inclawbator** | Post a request to the Inclawbate Council Telegram group. Council members pick it up. Paid in CLAWS. | ### Info @@ -123,8 +121,8 @@ curl -X POST ".../agent-chat" -d '{"message": "launch a token called DogPark, sy # Health check curl -X POST ".../agent-chat" -d '{"message": "how is my project doing?", "wallet": "0x..."}' -# Find a designer -curl -X POST ".../agent-chat" -d '{"message": "I need a logo designer"}' +# Hire the council +curl -X POST ".../agent-chat" -d '{"message": "I need a logo designed for my project"}' # Airdrop tokens curl -X POST ".../agent-chat" -d '{"message": "airdrop 1000 CLAWS to 50 wallets"}' diff --git a/inclawbate/references/api-endpoints.md b/inclawbate/references/api-endpoints.md index 2f451237..4aa0128a 100644 --- a/inclawbate/references/api-endpoints.md +++ b/inclawbate/references/api-endpoints.md @@ -51,10 +51,8 @@ The Inclawbator is a conversational agent. Send a message, it picks the right to | `build_landing_page` | "make a landing page", "build a website" | | `browse_apps` | "show me apps", "what apps exist" | | `suggest_app_ideas` | "app ideas", "what should I build" | -| `browse_inclawbators` | "find a designer", "hire a developer" | -| `hire_inclawbator` | "hire [handle]", "I want to work with [name]" | -| `browse_open_gigs` | "open gigs", "available work", "freelance jobs" | -| `check_hire_status` | "check on my hire", "follow up" | +| `browse_inclawbators` | "find a designer", "who can help with dev" | +| `hire_inclawbator` | "I need a logo", "hire someone for marketing" — posts to Council | | `get_ecosystem_info` | "what is Inclawbate", "tell me about CLAWS" | | `get_incubation_info` | "full incubation", "handle everything for me" | | `get_staking_info` | "how do I stake", "staking info" | @@ -72,8 +70,7 @@ These return raw JSON without the conversational agent: | `/api/inclawbate/fee-report?wallet=0x...` | GET | Pending WETH fees, per-token daily earnings | | `/api/inclawbate/health-check?address=0x...` | GET | Token price, volume, staking, suggestions | | `/api/inclawbate/apps` | GET | Browse app store. `?search=`, `?category=` | -| `/api/inclawbate/inclawbators` | GET | Browse human freelancers. `?skill=design` | -| `/api/inclawbate/gigs` | GET | Open gig requests | +| `/api/inclawbate/inclawbators` | GET | Browse the Inclawbate Council. `?skill=design` | --- From df10df6cfc7901749c76535be5dca1f92c461c3f Mon Sep 17 00:00:00 2001 From: stuart5915 Date: Wed, 18 Mar 2026 16:22:55 -0400 Subject: [PATCH 4/4] Trim to 11 bot-usable tools, remove browser-only and internal tools --- inclawbate/SKILL.md | 54 +++++++++----------------- inclawbate/references/api-endpoints.md | 20 ++-------- 2 files changed, 22 insertions(+), 52 deletions(-) diff --git a/inclawbate/SKILL.md b/inclawbate/SKILL.md index a3a24a8e..583374d3 100644 --- a/inclawbate/SKILL.md +++ b/inclawbate/SKILL.md @@ -1,11 +1,10 @@ --- name: inclawbator description: > - The Inclawbator — full-service AI agent for launching and managing Web3 projects. - Launch tokens (Base/Solana), deploy staking pools, create marketing agents, airdrop tokens, - run health checks, hire human freelancers, build apps and landing pages, check fees, - book promos, and manage your entire project — all through one conversational API. - Talk to it at inclawbate.com or via the REST API. + The Inclawbator — AI agent for launching and managing Web3 projects. + Launch tokens (Base/Solana), deploy staking pools, create marketing agents, + airdrop tokens, run health checks, book promos, hire the Inclawbate Council, + and get full-service incubation — all through one conversational API. metadata: openclaw: emoji: "🦞" @@ -16,14 +15,13 @@ metadata: # The Inclawbator — AI Agent for Web3 Projects -The Inclawbator is an AI agent that launches and manages Web3 projects end-to-end. Launch tokens, deploy staking, create marketing agents, airdrop tokens, hire humans, build apps — all through one conversation. +The Inclawbator is an AI agent that launches and manages Web3 projects. Launch tokens, deploy staking, create marketing agents, airdrop tokens, hire the council — all through one conversation. Live at [inclawbate.com](https://inclawbate.com). Powered by Groq. Free to use. ## Talk to It ```bash -# Send a message to the Inclawbator curl -X POST "https://inclawbate.com/api/inclawbate/agent-chat" \ -H "Content-Type: application/json" \ -d '{ @@ -33,58 +31,45 @@ curl -X POST "https://inclawbate.com/api/inclawbate/agent-chat" \ # → { reply, function_called, session_id } ``` -The agent handles tool selection automatically. Just describe what you need in plain language. +The agent handles tool selection automatically. Just describe what you need. -## What It Can Do (21 Tools) +## What It Can Do (11 Tools) ### Launch & Deploy | Tool | What it does | |------|-------------| -| **Launch Token** | Deploy a new token on Base (via Clanker) or Solana (via Bags/Meteora). Walks you through name, symbol, description, image, socials. | +| **Launch Token** | Deploy a new token on Base (via Clanker) or Solana (via Bags/Meteora). Name, symbol, description, image, socials. | | **Deploy Staking** | Create a staking pool for any token via the Staking Factory. Holders stake → earn CLAWS rewards. | -| **Register Project** | Already have a token? Register it in the Inclawbate ecosystem to get staking, agents, and the CLAWS reward flywheel. | -### Manage & Monitor +### Monitor | Tool | What it does | |------|-------------| -| **Health Check** | Comprehensive project diagnostic — token price, volume, liquidity, staking stats, and actionable suggestions. | +| **Health Check** | Project diagnostic — token price, volume, liquidity, staking stats, actionable suggestions. | | **Token Analytics** | Real-time price, volume, liquidity from DexScreener for any token address. | -| **Staking Stats** | Live TVL, APY, total stakers, distribution rates. Optionally check a specific wallet's position. | -| **Project Status** | See all projects launched by a wallet — tokens, staking, chain. | -| **User Workspace** | Everything a connected wallet has built — apps, marketing agents, vaults. | +| **Staking Stats** | Live TVL, APY, total stakers, distribution rates. Check a specific wallet's position. | ### Marketing & Growth | Tool | What it does | |------|-------------| -| **Create Marketing Agent** | Set up an AI agent that auto-posts to X/Twitter on your project's behalf. Set a schedule and let it run forever. Free. | -| **Book Promo** | Promote your project through the @inclawbate X account. Shoutout, campaign, or featured tier — paid in CLAWS. | +| **Create Marketing Agent** | AI agent that auto-posts to X/Twitter on your project's behalf. Set a schedule, runs forever. Free. | +| **Book Promo** | Promote through the @inclawbate X account. Shoutout, campaign, or featured — paid in CLAWS. | | **Airdrop Tokens** | Distribute tokens to multiple wallets in one transaction via the Disperse contract. | -### Build - -| Tool | What it does | -|------|-------------| -| **Build App** | Create a web app using the AI app builder at inclawbate.com/build. No code needed. | -| **Build Landing Page** | Create a branded project page with the AI builder. | -| **Browse Apps** | Discover 12+ community-built apps — games, tools, dashboards. | -| **Suggest App Ideas** | Get app ideas based on your interests (defi, gaming, social, tools, AI). | - ### Hire the Council | Tool | What it does | |------|-------------| -| **Browse Inclawbators** | See the Inclawbate Council — vetted humans available for design, dev, marketing, content, strategy. | -| **Hire Inclawbator** | Post a request to the Inclawbate Council Telegram group. Council members pick it up. Paid in CLAWS. | +| **Hire Council** | Post a request to the Inclawbate Council — vetted humans for design, dev, marketing, content, strategy. Request goes to the Council Telegram group, members pick it up. Paid in CLAWS. | ### Info | Tool | What it does | |------|-------------| -| **Ecosystem Info** | Overview of Inclawbate — what it is, key links, CLAWS token. | -| **Incubation Info** | Full-service incubation details — token + staking + branding + marketing as a package. | +| **Ecosystem Info** | What is Inclawbate, CLAWS token, key links, how it all works. | +| **Incubation Info** | Full-service incubation — token + staking + branding + marketing as a package. | ## API @@ -110,9 +95,9 @@ POST https://inclawbate.com/api/inclawbate/agent-chat } ``` -The agent picks the right tool automatically based on your message. Multi-turn conversations are supported via `session_id`. +Multi-turn conversations supported via `session_id`. -## Example Conversations +## Examples ```bash # Launch a token @@ -131,7 +116,7 @@ curl -X POST ".../agent-chat" -d '{"message": "airdrop 1000 CLAWS to 50 wallets" curl -X POST ".../agent-chat" -d '{"message": "create a staking pool for my token 0xABC..."}' # Book a promo -curl -X POST ".../agent-chat" -d '{"message": "I want to promote my project on the Inclawbate X account"}' +curl -X POST ".../agent-chat" -d '{"message": "promote my project on the Inclawbate X account"}' ``` ## Token @@ -147,6 +132,5 @@ curl -X POST ".../agent-chat" -d '{"message": "I want to promote my project on t - **Talk to it:** https://inclawbate.com - **Agent page:** https://inclawbate.com/inclawbator -- **App Store:** https://inclawbate.com/apps - **Staking:** https://inclawbate.com/stake - **Skills Directory:** https://inclawbate.com/skills diff --git a/inclawbate/references/api-endpoints.md b/inclawbate/references/api-endpoints.md index 4aa0128a..d256dc1b 100644 --- a/inclawbate/references/api-endpoints.md +++ b/inclawbate/references/api-endpoints.md @@ -6,7 +6,7 @@ POST https://inclawbate.com/api/inclawbate/agent-chat ``` -The Inclawbator is a conversational agent. Send a message, it picks the right tool and responds. No tool selection needed on your end. +Conversational agent. Send a message, it picks the right tool and responds. **Request:** ```json @@ -26,42 +26,30 @@ The Inclawbator is a conversational agent. Send a message, it picks the right to } ``` -**`function_called`** tells you which tool the agent used (or null if it just replied). Useful for programmatic flows. - --- -## Available Tools (auto-selected by the agent) +## Tools (auto-selected by the agent) | Tool | Trigger phrases | |------|----------------| | `launch_token_info` | "launch a token", "create a token", "deploy a token" | | `configure_token_launch` | (called automatically as you provide token details) | | `deploy_staking` | "create staking pool", "add staking to my token" | -| `register_project` | "register my existing token", "join Inclawbate ecosystem" | | `health_check` | "how is my project doing", "check my token" | | `get_token_analytics` | "price of 0x...", "volume for my token" | | `get_staking_stats` | "staking APY", "TVL", "my staking position" | -| `get_project_status` | "what have I launched", "my projects" | -| `get_user_workspace` | "what have I built", "my workspace" | | `create_agent_info` | "create marketing agent", "auto-post to X" | -| `setup_x_agent` | "set up X agent", "automated posting" | | `book_promo` | "promote my project", "buy a shoutout" | | `disperse_tokens` | "airdrop tokens", "distribute to wallets" | -| `build_app_info` | "build an app", "create an app" | -| `build_landing_page` | "make a landing page", "build a website" | -| `browse_apps` | "show me apps", "what apps exist" | -| `suggest_app_ideas` | "app ideas", "what should I build" | -| `browse_inclawbators` | "find a designer", "who can help with dev" | | `hire_inclawbator` | "I need a logo", "hire someone for marketing" — posts to Council | | `get_ecosystem_info` | "what is Inclawbate", "tell me about CLAWS" | | `get_incubation_info` | "full incubation", "handle everything for me" | -| `get_staking_info` | "how do I stake", "staking info" | --- ## Direct Data Endpoints -These return raw JSON without the conversational agent: +Raw JSON without the conversational agent: | Endpoint | Method | Description | |----------|--------|-------------| @@ -69,8 +57,6 @@ These return raw JSON without the conversational agent: | `/api/inclawbate/staking` | GET | Treasury stats, top stakers. Add `?wallet=0x...` for position | | `/api/inclawbate/fee-report?wallet=0x...` | GET | Pending WETH fees, per-token daily earnings | | `/api/inclawbate/health-check?address=0x...` | GET | Token price, volume, staking, suggestions | -| `/api/inclawbate/apps` | GET | Browse app store. `?search=`, `?category=` | -| `/api/inclawbate/inclawbators` | GET | Browse the Inclawbate Council. `?skill=design` | ---