meta-stamp-pockets

Pull licensed creator content from a specific pocket by ID. Use this tool when an AI agent needs to retrieve verified, provenance-tracked content for generation, RAG, or training purposes. Do NOT use for browsing or discovery — use search_pockets or list_pockets instead. Requires a valid Bearer token for authentication; unauthenticated requests return HTTP 401. Successful pulls trigger a metered charge ($0.001–$0.25 depending on content tier) and the transaction is logged for creator royalty distribution. The pocket_id parameter is a 24-character hex string identifying the specific content pocket to pull from. Returns the full content payload with provenance metadata including creator attribution and license terms.

{
  "type": "object",
  "properties": {
    "pocket_id": {
      "type": "string",
      "description": "The 24-character hex identifier of the content pocket to pull from. Obtain this from search_pockets or list_pockets results."
    },
    "query": {
      "type": "string",
      "description": "Optional natural language focus query used to narrow or contextualize the returned content within the selected pocket."
    }
  },
  "required": [
    "pocket_id"
  ]
}

Search the Meta-Stamp Pockets catalog by keyword, creator email, or content category. Use this tool when an AI agent needs to discover available licensed content before pulling it. Ideal for finding relevant pockets when the agent knows what topic or creator it needs but not the specific pocket ID. Does NOT retrieve content — use pull_content with the returned pocket_id to access actual content. Requires a valid Bearer token. The query parameter accepts natural language search terms or category keywords; the creator_email parameter restricts results to a single creator by their email address. Provide at least one of query or creator_email. Returns matching pockets with their IDs, titles, descriptions, creators, content types, and pricing tiers. Use the limit parameter to control page size.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Natural language search terms or category keywords to find matching content pockets. Optional when creator_email is provided."
    },
    "creator_email": {
      "type": "string",
      "description": "Optional filter to show only pockets created by the creator with this email address. Case-insensitive exact match on the email."
    },
    "content_type": {
      "type": "string",
      "description": "Optional filter to show only pockets in a specific content category or source type, such as 'youtube', 'webpage', 'video', 'text', 'image', or 'audio'."
    },
    "limit": {
      "type": "integer",
      "description": "Maximum number of results to return per page. Defaults to 10, maximum 50 for search results."
    }
  },
  "required": []
}

List all available content pockets in the Meta-Stamp Pockets catalog, optionally filtered by creator. Use this tool when an AI agent needs to browse the full catalog or see everything available from a specific creator. Prefer search_pockets when looking for specific topics. Does NOT retrieve content — use pull_content with the returned pocket_id to access actual content. Requires a valid Bearer token. Optional creator_id parameter filters results to a single creator's pockets. Returns a paginated list of pockets with IDs, titles, descriptions, creators, content types, and pricing tiers.

{
  "type": "object",
  "properties": {
    "creator_id": {
      "type": "string",
      "description": "Optional filter to show only pockets from a specific creator. Use the creator's unique identifier."
    },
    "limit": {
      "type": "integer",
      "description": "Maximum number of results to return per page. Defaults to 50, maximum 200 for catalog browsing."
    }
  },
  "required": []
}