youspot

The official Ruby client for YouSpot, the AI-native personal CRM. Standard library only, Ruby 2.7 or newer.

gem install youspot

Everything except call_tool works with no credential. Every YouSpot tool reads one person's own contacts, companies, notes and files, so a token always belongs to a person: mint one at youspot.com/user/mcp and set YOUSPOT_TOKEN, or follow the OAuth 2.1 flow in auth.md.

require "youspot"

client = YouSpot::Client.new

answer = client.ask("how do I connect an MCP client", limit: 3)
answer["results"].each { |hit| puts "#{hit["name"]}: #{hit["url"]}" }

client.tools                                                          # every tool on the product server
client.call_sandbox_tool("search_graph_objects", { query: "Meridian" })  # the demo account, no credential
client.call_tool("get_connections_summary")                           # needs YOUSPOT_TOKEN
client.batch([{ id: "dir", path: "/api/network/members", query: { q: "consulting" } }])

Method	What it does	Credential
`index`	Every endpoint, and what each one costs in credentials	none
`ask`	A question about YouSpot, answered from its own pages	none
`search_docs`, `read_doc`, `list_docs`	The developer docs over the documentation MCP server	none
`read_markdown`	Any public page as markdown	none
`tools`	The tools on the product MCP server	none
`call_tool`	One tool, as the member whose token the client holds	`YOUSPOT_TOKEN`
`sandbox_tools`, `call_sandbox_tool`	The read tools over a demo account	none
`member`, `directory`	Public profiles and the public directory	none
`batch`	Up to 20 reads in one round trip	none
`identity`	What identity the caller can hold here	optional

Every failure raises YouSpot::Error carrying status, the stable code and the url. YOUSPOT_BASE_URL overrides the origin.

The machine descriptions this client follows: openapi.json, the MCP server card, agents.md and llms.txt. Developer docs: https://youspot.com/docs.

MIT licensed. Support: support@youspot.com.

youspot

Development

youspot