{
  "schema_version": "0.1",
  "provider": {
    "name": "Satoshi's House",
    "url": "https://satoshishouse.com",
    "description": "Portal de noticias, analises e guias sobre criptomoedas, Bitcoin, Ethereum, DeFi, Web3 e blockchain.",
    "language": "pt-BR",
    "team": ["Ryan Meneguelli", "Salin Neto"],
    "contact": "contato@satoshishouse.com"
  },
  "tools": [
    {
      "name": "getLatestNews",
      "description": "Buscar os artigos mais recentes do portal. Retorna titulo, descricao, slug, categoria, tags, data e imagem.",
      "endpoint": "/data/noticias.json",
      "method": "GET",
      "parameters": [],
      "returns": {
        "type": "object",
        "properties": {
          "site": { "type": "object", "description": "Metadados do site" },
          "categories": { "type": "array", "description": "Lista de categorias disponiveis" },
          "posts": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "title": { "type": "string" },
                "slug": { "type": "string" },
                "description": { "type": "string" },
                "category": { "type": "string" },
                "tags": { "type": "array", "items": { "type": "string" } },
                "author": { "type": "string" },
                "date": { "type": "string", "format": "date-time" },
                "image": { "type": "string", "format": "uri" },
                "wordCount": { "type": "integer" },
                "featured": { "type": "boolean" }
              }
            }
          }
        }
      },
      "notes": "O endpoint retorna todos os artigos. O agente deve ordenar por 'date' (desc) para obter os mais recentes e pode filtrar por categoria ou tags."
    },
    {
      "name": "getArticleBySlug",
      "description": "Buscar um artigo especifico pelo slug. Como o site e estatico, o endpoint retorna todos os artigos e o agente deve filtrar pelo campo 'slug' desejado.",
      "endpoint": "/data/noticias.json",
      "method": "GET",
      "parameters": [
        {
          "name": "slug",
          "type": "string",
          "required": true,
          "description": "O slug do artigo (ex: 'guia-completo-bitcoin'). O agente filtra client-side."
        }
      ],
      "notes": "O artigo completo esta em /noticias/{slug}/index.html. O JSON contem apenas metadados."
    },
    {
      "name": "listGuides",
      "description": "Listar todos os guias definitivos sobre criptomoedas e blockchain. Retorna 33 guias organizados por nivel (fundamentos, operacao, analise, avancado, protecao).",
      "endpoint": "/data/guias.json",
      "method": "GET",
      "parameters": [],
      "returns": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "title": { "type": "string" },
            "slug": { "type": "string" },
            "description": { "type": "string" },
            "level": { "type": "string", "enum": ["fundamentos", "operacao", "analise", "avancado", "protecao"] },
            "url": { "type": "string", "format": "uri" }
          }
        }
      }
    },
    {
      "name": "listTools",
      "description": "Listar todas as 19 ferramentas interativas de analise cripto disponiveis na area de membros. Inclui calculadoras, rastreadores, analisadores e IA.",
      "endpoint": "/data/ferramentas.json",
      "method": "GET",
      "parameters": [],
      "returns": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "id": { "type": "string" },
            "title": { "type": "string" },
            "description": { "type": "string" },
            "category": { "type": "string" },
            "plan": { "type": "string", "enum": ["free", "pro", "premium"] },
            "url": { "type": "string", "format": "uri" }
          }
        }
      }
    },
    {
      "name": "listPlans",
      "description": "Listar os planos de assinatura disponiveis (Free, Pro R$4.99/mes, Premium R$14.99/mes) com suas funcionalidades.",
      "endpoint": "/data/planos.json",
      "method": "GET",
      "parameters": [],
      "returns": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "id": { "type": "string" },
            "name": { "type": "string" },
            "price": { "type": "string" },
            "features": { "type": "array", "items": { "type": "string" } }
          }
        }
      }
    },
    {
      "name": "listFAQ",
      "description": "Listar perguntas frequentes sobre o portal, planos, ferramentas e criptomoedas em geral.",
      "endpoint": "/data/faq.json",
      "method": "GET",
      "parameters": [],
      "returns": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "question": { "type": "string" },
            "answer": { "type": "string" },
            "category": { "type": "string" }
          }
        }
      }
    },
    {
      "name": "getCryptoPrices",
      "description": "Obter precos atuais das principais criptomoedas em BRL. Dados atualizados periodicamente via CoinMarketCap. Retorna simbolo, nome, preco, variacao 24h e ranking.",
      "endpoint": "/data/quotes.json",
      "method": "GET",
      "parameters": [],
      "returns": {
        "type": "object",
        "properties": {
          "generatedAt": { "type": "string", "format": "date-time" },
          "source": { "type": "string" },
          "currency": { "type": "string" },
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "symbol": { "type": "string" },
                "name": { "type": "string" },
                "price": { "type": "number" },
                "change24h": { "type": "number" },
                "rank": { "type": "integer" }
              }
            }
          }
        }
      },
      "notes": "Precos em BRL. O agente pode filtrar por symbol client-side."
    },
    {
      "name": "getMarketReports",
      "description": "Obter relatorios semanais e mensais de analise do mercado cripto. Inclui analise on-chain, sentimento, performance e projecoes.",
      "endpoint": "/data/reports.json",
      "method": "GET",
      "parameters": [],
      "returns": {
        "type": "object",
        "properties": {
          "reports": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "title": { "type": "string" },
                "slug": { "type": "string" },
                "type": { "type": "string", "enum": ["weekly", "monthly"] },
                "description": { "type": "string" },
                "highlights": { "type": "array", "items": { "type": "string" } },
                "stats": { "type": "object" },
                "date": { "type": "string", "format": "date-time" },
                "url": { "type": "string", "format": "uri" }
              }
            }
          },
          "totalReports": { "type": "integer" },
          "weeklyCount": { "type": "integer" },
          "monthlyCount": { "type": "integer" }
        }
      },
      "notes": "O agente pode filtrar por type (weekly/monthly) e ordenar por date client-side."
    },
    {
      "name": "submitContact",
      "description": "Enviar mensagem de contato para a equipe do Satoshi's House.",
      "endpoint": "https://api.satoshishouse.com/api/contact",
      "method": "POST",
      "parameters": [
        { "name": "name", "type": "string", "required": true, "description": "Nome do remetente" },
        { "name": "email", "type": "string", "required": true, "description": "Email do remetente" },
        { "name": "message", "type": "string", "required": true, "description": "Mensagem" }
      ]
    }
  ],
  "context": {
    "llms_txt": "https://satoshishouse.com/llms.txt",
    "llms_full_txt": "https://satoshishouse.com/llms-full.txt",
    "sitemap": "https://satoshishouse.com/sitemap.xml",
    "robots": "https://satoshishouse.com/robots.txt",
    "webmcp_manifest": "https://satoshishouse.com/.well-known/webmcp.json"
  },
  "authentication": {
    "type": "bearer",
    "description": "Ferramentas da area de membros requerem autenticacao JWT via localStorage. Endpoints publicos (noticias, guias, FAQ, planos) nao requerem autenticacao."
  }
}