# Json To Social Card — MCP tool `findutils:json_to_social_card`

Generate a social-media / Open Graph card (1200x630 aspect) from JSON such as {"title","description","author","date","siteName","tag","background","textColor"} in one of 6 templates. Returns the card three ways: inline-style HTML, Tailwind CSS markup, and a React JSX component.

- Category: data
- MCP server: https://mcp.findutils.com/ (Streamable HTTP, no API keys, 120 req/min per IP)
- REST endpoint: POST https://api.findutils.com/api/tools/json-to-social-card/execute (no API keys, 60 req/min per IP)
- Reference page: https://findutils.com/mcp/json-to-social-card/
- Same tool on the other surface: https://findutils.com/api/json-to-social-card/

## Connect

```bash
claude mcp add findutils --transport http https://mcp.findutils.com/
```

Claude Desktop (`claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "findutils": {
      "url": "https://mcp.findutils.com/"
    }
  }
}
```

## Call the tool (verified example)

```bash
curl -X POST https://mcp.findutils.com/ \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "json_to_social_card",
      "arguments": {
        "json": "{\"title\":\"How to Build Better Developer Tools\",\"description\":\"A guide to great DX.\",\"author\":\"Jane Developer\",\"date\":\"2024-01-15\",\"siteName\":\"DevBlog\",\"tag\":\"Engineering\"}"
      }
    }
  }'
```

## Input schema

| Argument | Type | Required | Description |
|---|---|---|---|
| `json` | string | yes | Card JSON: {"title": string, "description"?, "author"?, "avatar"?: url, "date"?, "siteName"?, "logo"?: url, "background"?: css color, "textColor"?: css color, "tag"?}. |
| `template` | string (og-classic \| blog-post \| dark-modern \| gradient-hero \| minimal-clean \| brand-bold) | no | Card template. Default "og-classic". Default: `"og-classic"`. |

Example arguments (verified):

```json
{
  "json": "{\"title\":\"How to Build Better Developer Tools\",\"description\":\"A guide to great DX.\",\"author\":\"Jane Developer\",\"date\":\"2024-01-15\",\"siteName\":\"DevBlog\",\"tag\":\"Engineering\"}"
}
```

Decoded `json` argument (readability only — send it as a string):

```json
{
  "title": "How to Build Better Developer Tools",
  "description": "A guide to great DX.",
  "author": "Jane Developer",
  "date": "2024-01-15",
  "siteName": "DevBlog",
  "tag": "Engineering"
}
```

## Also a REST endpoint

```bash
curl -X POST https://api.findutils.com/api/tools/json-to-social-card/execute \
  -H "Content-Type: application/json" \
  -d '{
    "json": "{\"title\":\"How to Build Better Developer Tools\",\"description\":\"A guide to great DX.\",\"author\":\"Jane Developer\",\"date\":\"2024-01-15\",\"siteName\":\"DevBlog\",\"tag\":\"Engineering\"}"
  }'

# Parameter schema
curl https://api.findutils.com/api/tools/json-to-social-card
```

Full REST reference: https://findutils.com/api/json-to-social-card/ · OpenAPI 3.1 spec: https://findutils.com/api/openapi.json

---
Full catalog: POST https://mcp.findutils.com/ with method `tools/list` · https://findutils.com/mcp/ · https://findutils.com/llms.txt