Charmshots

io.github.charmshotsPublished by GitHub account charmshotsv1.2.1Updated Oct 25, 2026

Read-only MCP connector for Charmshots photoshoots, photo metadata and owner-authenticated links.

VerifiedStreamable HTTPWeb executableFiles & Storage Media & Design

Server details

Identifier: io.github.charmshots/mcp-server
Transport: Streamable HTTP
Runtime: Web executable
Trust: Verified
Published: Sep 22, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account charmshots for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.charmshots%2Fmcp-server.svg)](https://sourceweft.com/mcp/io.github.charmshots%2Fmcp-server?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Read-only connector to Charmshots that lets an assistant browse your AI portrait photoshoots, photo metadata and owner-authenticated download links.

What you can do: Read the signed-in account context and profile details via get_profile and related tools. Browse owned photoshoots newest first and read a selected shoot's metadata and status. List photos with labels, styles, statuses and owner-authenticated download links, distinguishing ready results from queued or incomplete work. Summarize the status of saved photoshoots without generating new images.
When to use it: Useful when you already have a Charmshots account and want an assistant to find a recent photoshoot, list which photos are ready to download, or summarize shoot status and styles without opening the site.
Requirements: A remote Streamable HTTP endpoint with OAuth sign-in in the browser, or the npm package charmshots-mcp run locally over stdio, which needs Node.js 22 or newer. An existing Charmshots account is required; requested scopes are profile:read and photos:read.

Before you install

Read-only: it does not generate or analyze images and does not spend credits. Download links require the owner's product sign-in and are not public share links. OAuth tokens stored locally are credentials; only approve connections you started and never share cookies or tokens. Photo metadata is not a visual quality assessment.

Installation

In SourceWeft

Open Charmshots in the dashboard and add it to a workspace.
Connect the required credentials. They are stored privately and never shown on public pages.
Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.charmshots%2Fmcp-server/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "charmshots": {
      "type": "http",
      "url": "https://mcp.charmshots.com/mcp"
    }
  }
}

README

Charmshots MCP

AI portraits for dating profiles and everyday introductions.

Charmshots creates portraits from your own selfies, with settings and styles for dating profiles, headshots and everyday introductions. Choose scenes that fit your life, review each result closely, and keep the frames that feel like you. The photo collection, practical guides and free image tools help you plan a more considered profile.

Website · MCP repository · Agent skill · npm package

What this connector does

This package connects a local stdio MCP client to the hosted Charmshots MCP server. Hosted tools run on Cloudflare; the local package bridges the connection and opens browser-based OAuth. You do not need to deploy a Worker or paste a product password into your assistant.

Tool	What it does
`get_profile`	Read the signed-in account context.
`list_photoshoots`	Browse existing owned photoshoots, newest first.
`get_photoshoot`	Read the selected shoot’s metadata and status.
`list_photos`	List existing photo labels, styles, statuses and owner-authenticated download links.

The MCP does not generate or analyze images and does not spend credits. Photo metadata is not a visual quality assessment, and download links require the owner’s product sign-in. The website currently says purchases are temporarily paused; browse the current collection and availability before planning a new shoot. AI portraits cannot guarantee dating matches.

Example workflow

Find the requested photoshoot in the signed-in account.
List its available photos, distinguishing ready results from queued or incomplete work.
Return the relevant product or download links so the owner can inspect the actual images.

Things to ask your assistant

Find my most recent photoshoot and list the photos that are ready to download.

Show the labels and styles in this shoot, with the available download links.

Summarize the status of my saved photoshoots without generating new images.

Connect a remote MCP client

Open the client’s custom MCP or connector settings.
Enter https://mcp.charmshots.com/mcp as the remote server URL.
Complete Charmshots sign-in in your browser and review the permissions on the consent screen.
Return to the client and load the available tools.

Use a client that supports Streamable HTTP MCP and OAuth. Custom-connector availability depends on the client and your account. A public repository or npm release does not mean the integration has been approved for a client’s marketplace.

Claude Desktop and other stdio clients

Requires Node.js 22 or newer and an existing Charmshots account. Add this entry to your client’s MCP configuration:

json

{  "mcpServers": {    "charmshots": {      "command": "npx",      "args": [        "-y",        "charmshots-mcp"      ]    }  }}

{  "mcpServers": {    "charmshots": {      "command": "npx",      "args": [        "-y",        "charmshots-mcp"      ]    }  }}

You can also run npx -y charmshots-mcp from a terminal to start the bridge. It speaks MCP over stdio; it is not an interactive chat interface. For desktop clients that support MCPB extensions, download the .mcpb file from Charmshots releases.

Permissions and account access

Requested scopes: profile:read photos:read. Older profile-only connections need to reconnect and explicitly approve the additional permissions before content tools are available.

Only approve a connection you intended to start. If sign-in opens a new tab, finish it, return to the consent screen and refresh. Manage or revoke connected apps.

The package uses pinned mcp-remote for OAuth, PKCE and local token storage. Tokens on your computer are credentials. The connector uses the fixed endpoint above and rejects command-line endpoint overrides. Product passwords and underlying provider credentials are not requested by this package.

Troubleshooting

No tools or insufficient permissions: reconnect through browser consent and check the selected account.
An empty list: confirm that the account owns the expected items. Empty results are different from a failed request.
A link asks you to sign in: open it with the owning product account; a private product link is not a public share link.
The browser blocks authorization: inspect the browser’s displayed error and restart an expired request from the client. Never send cookies or tokens in an issue.

Add the companion skill

The Charmshots agent skill explains how to select the right records, interpret results and respect the workflow’s limits:

Learn more about Charmshots

Development and support

Report a connector issue with your client, Node.js version and a redacted error. Keep package.json, manifest.json, server/config.json, server.json and the lockfile version aligned for releases. GitHub Actions publishes versioned npm packages and MCPB assets. See LICENSE for the MIT license.

Source: README.md at commit 7410456

Tools

This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

v1.2.1LatestSep 22, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 daysRequired25 pts
Auth declaredRequired10 pts
Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts