MCP Tools
creator_lookup
Look up a creator by platform and handle.
Look up a creator by platform and handle. Returns creator info and subscription status. Use before subscription_create to check if already subscribed.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
platform | string | Yes | Platform: x, instagram, tiktok, youtube, linkedin |
handle | string | Yes | Creator's handle/username (1-100 characters) |
Example
Prompt
Look up @naval on XResponse (not subscribed)
{
"creator": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"platform": "x",
"handle": "naval",
"displayName": "Naval",
"avatarUrl": "https:<COMMENT>//pbs.twimg.com/profile_images/...",</COMMENT>
"bio": "Angel investor, founder",
"followerCount": 2100000,
"createdAt": "2024-01-15T10: <NUMBER>30</NUMBER>: <NUMBER>00</NUMBER>Z"
},
"subscription": null,
"isSubscribed": false
}Response (already subscribed)
{
"creator": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"platform": "x",
"handle": "naval",
"displayName": "Naval",
"avatarUrl": "https:<COMMENT>//pbs.twimg.com/profile_images/...",</COMMENT>
"bio": "Angel investor, founder",
"followerCount": 2100000,
"createdAt": "2024-01-15T10: <NUMBER>30</NUMBER>: <NUMBER>00</NUMBER>Z"
},
"subscription": {
"id": "sub_123",
"status": "active",
"dailyUpdates": true,
"createdAt": "2024-02-01T09: <NUMBER>00</NUMBER>: <NUMBER>00</NUMBER>Z"
},
"isSubscribed": true
}Response Fields
creator
| Field | Type | Description |
|---|---|---|
id | string | Creator UUID |
platform | string | Platform identifier |
handle | string | Username/handle |
displayName | string | Display name |
avatarUrl | string | Profile image URL |
bio | string | Profile bio |
followerCount | number | Number of followers |
Use Cases
- Check if a creator exists before subscribing
- Verify subscription status
- Get creator metadata (follower count, bio)