primary-logic

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Primary Logic Investment Intelligence

Primary Logic 投资情报

Use the Primary Logic MCP tools to retrieve real-time, continuously refreshed investment context with LLM-ranked relevance and impact signals for public and private companies.

使用Primary Logic MCP工具获取实时、持续更新的投资背景信息，其中包含由LLM针对上市公司和私有公司生成的相关性及影响信号排名。

Setup

配置步骤

Claude Code / Cowork (recommended)

Claude Code / Cowork（推荐方式）

bash

claude plugins add PrimaryLogic/agent-skills

bash

claude plugins add PrimaryLogic/agent-skills

Codex

bash

codex mcp add primary-logic --url https://primarylogic--pulse-backend-external-api-app.modal.run/mcp

bash

codex mcp add primary-logic --url https://primarylogic--pulse-backend-external-api-app.modal.run/mcp

Other MCP-capable agents

其他支持MCP的智能体

Add to your agent's MCP config:

URL:

https://primarylogic--pulse-backend-external-api-app.modal.run/mcp

Auth: OAuth (automatic) or Bearer token with API key

在智能体的MCP配置中添加以下信息：

URL:

https://primarylogic--pulse-backend-external-api-app.modal.run/mcp

认证方式: OAuth（自动）或带API密钥的Bearer令牌

npx (universal)

npx（通用方式）

bash

npx skills add PrimaryLogic/agent-skills

bash

npx skills add PrimaryLogic/agent-skills

Activation Cues

触发场景

Activate this skill when the user asks for any of:

ticker-specific bullish or bearish evidence
recent catalysts or risk signals from content
per-content relevance or impact details by ticker
source coverage or content visibility checks
API key usage diagnostics
setup help for agentic decision support or user-controlled trading workflows

当用户提出以下请求时，激活该技能：

特定股票代码的看多或看空依据
来自各类内容的近期催化剂或风险信号
按股票代码划分的单条内容相关性及影响细节
来源覆盖范围或内容可见性查询
API密钥使用诊断
用于智能体决策支持或用户可控交易流程的配置帮助

What This Data Represents

数据说明

Source-normalized investment context: top podcasts, articles/news, X/Twitter, Kalshi, Polymarket, earnings calls, filings, and other monitored channels normalized into one feed
LLM-heavy signal extraction: per-ticker relevance and impact scores attached to each content item to prioritize material developments
Public + private company coverage: source visibility and ticker coverage for the requesting organization

标准化的投资背景信息：将来自顶级播客、文章/新闻、X/Twitter、Kalshi、Polymarket、财报电话会议、备案文件及其他监控渠道的信息统一整合为单一信息流
基于LLM的信号提取：为每条内容添加按股票代码划分的相关性和影响评分，优先展示重要动态
覆盖上市与私有公司：支持查询请求方机构的来源可见性和股票代码覆盖范围

Connection

连接配置

MCP server:
```
primary-logic
```
connector

Base URL:

https://primarylogic--pulse-backend-external-api-app.modal.run/mcp

Auth: Bearer token via
```
PRIMARYLOGIC_API_KEY
```
environment variable

MCP服务器：
```
primary-logic
```
连接器

基础URL：

https://primarylogic--pulse-backend-external-api-app.modal.run/mcp

认证方式：OAuth（自动）或带API密钥的Bearer令牌

Available MCP Tools

可用MCP工具

Use the

primary-logic

connector tools:

Tool	Purpose
`health_check`	Validate connectivity and auth
`search_content`	Broad content discovery with filters (tickers, sources, sentiment, time)
`get_content`	Fetch a single content item by ID
`get_content_ticker_signals`	Per-item ticker attribution with relevance and impact
`get_ticker_content`	Signal-ranked content for a specific ticker
`list_sources`	Org source visibility and coverage
`list_tickers`	Search available tickers
`get_ticker_detail`	Ticker summary with optional signal stats
`get_usage`	API usage telemetry

使用

primary-logic

连接器工具：

工具	用途
`health_check`	验证连接性和认证状态
`search_content`	带筛选条件的广泛内容检索（股票代码、来源、情绪、时间）
`get_content`	通过ID获取单条内容
`get_content_ticker_signals`	单条内容的股票代码归属及相关性、影响评分
`get_ticker_content`	按信号排名的特定股票代码相关内容
`list_sources`	机构的来源可见性及覆盖范围
`list_tickers`	搜索可用的股票代码
`get_ticker_detail`	股票代码摘要（可包含信号统计）
`get_usage`	API使用情况统计

Hard Rules

硬性规则

Never fabricate data; all claims must map to tool responses.
Access is user-entitlement scoped to the API key creator; if calls fail with billing errors, key-owner subscription status is usually the cause.
Data visibility is org-scoped; if records are missing, org source visibility may be the cause.
If a tool call fails, report the error and suggest a concrete next step.
Use absolute timestamps in outputs when the user asks about recent windows.
Do not claim market prices, positions, or execution events unless explicitly present in the data.
Do not present outputs as guaranteed returns or autonomous execution instructions.
Frame outputs as context for decision support and user-approved actions.

不得编造数据；所有结论必须对应工具返回的结果。
访问权限受API密钥创建者的用户权限限制；若调用因计费错误失败，通常是密钥所有者的订阅状态问题。
数据可见性受机构范围限制；若缺少记录，可能是机构的来源可见性设置问题。
若工具调用失败，需报告错误并给出具体的下一步建议。
当用户询问近期时段时，输出中使用绝对时间戳。
除非数据中明确包含，否则不得声称提供市场价格、持仓或执行事件信息。
不得将输出内容表述为保证收益或自主执行指令。
将输出内容定位为决策支持的背景信息及用户批准后的操作依据。

Input Contract

输入约定

Interpret each user request into this query plan:

objective: thesis_support, counter_thesis, catalyst_scan, sentiment_shift, coverage_check
scope:
- tickers: list of uppercase ticker symbols
- time window: since and until in ISO datetime format
- source_types: optional list
signal filters:
- min_relevance: 0..1
- min_abs_impact: 0..10
- sentiment: positive | negative | neutral
- include_reasoning: true when the user asks why
retrieval:
- limit (default 50)
- sort mode: date | abs_impact | relevance

If ticker or time window is missing for an investment query, ask one concise clarification.

将每个用户请求转换为以下查询计划：

目标：论点支持、反论点验证、催化剂扫描、情绪转变、覆盖范围检查
范围：
- 股票代码：大写股票代码列表
- 时间窗口：ISO datetime格式的起始和结束时间
- 来源类型：可选列表
信号筛选：
- 最低相关性：0..1
- 最低绝对影响：0..10
- 情绪：积极 | 消极 | 中性
- 包含推理过程：当用户询问原因时设为true
检索设置：
- 数量限制（默认50）
- 排序方式：日期 | 绝对影响 | 相关性

若投资查询中缺少股票代码或时间窗口，需简洁地询问用户补充信息。

Query Defaults

查询默认值

Default content limit: 50 unless user asks otherwise.
Apply ticker filters whenever the user names tickers.
For larger pulls, continue pagination while next_cursor is present.
For signal-heavy tasks, start with min_relevance >= 0.6 and min_abs_impact >= 5.

默认内容数量限制：50，除非用户另有要求。
当用户提及股票代码时，自动应用股票代码筛选。
对于大规模数据拉取，在存在next_cursor时继续分页。
对于侧重信号的任务，初始设置最低相关性≥0.6，最低绝对影响≥5。

Data Shape

数据结构

See response contracts for canonical payload examples.

参考响应约定获取标准返回示例。

Decision Workflow

决策流程

Validate connectivity once per session with
```
health_check
```
.
Use
```
search_content
```
for broad discovery pulls.
Use
```
get_ticker_content
```
for signal-ranked ticker analysis.
Use
```
get_content_ticker_signals
```
for per-item attribution detail.

Use

get_ticker_detail

with

include_signal_stats=true

for summary context.

Use
```
list_sources
```
when visibility or source scope is ambiguous.
Use
```
get_usage
```
for rate-limit troubleshooting.

每次会话开始时使用
```
health_check
```
验证连接性。
使用
```
search_content
```
进行广泛的内容发现。
使用
```
get_ticker_content
```
进行按信号排名的股票代码分析。
使用
```
get_content_ticker_signals
```
获取单条内容的归属细节。

使用

get_ticker_detail

并设置

include_signal_stats=true

获取摘要信息。

当可见性或来源范围不明确时，使用
```
list_sources
```
。
使用
```
get_usage
```
排查速率限制问题。

Output Contract

输出约定

Return structured investment output with:

key_findings: 3 to 7 concise bullets
thesis_view: one short paragraph
supporting_evidence: list of {content_id, ticker, impact_score, relevance_score}
contrary_evidence: same schema as supporting_evidence
catalysts: list
risks: list
tool_trace:
- tools used
- filters applied
- time window
- pagination coverage

If results are empty, return "no qualifying records" and suggest exactly which filter to relax first.

返回结构化的投资分析结果，包含：

核心发现：3-7条简洁要点
论点观点：一段简短的总结
支持证据：列表，每个元素包含{content_id, ticker, impact_score, relevance_score}
相反证据：与支持证据格式相同
催化剂：列表
风险：列表
工具追踪：
- 使用的工具
- 应用的筛选条件
- 时间窗口
- 分页覆盖范围

若无结果，返回“无符合条件的记录”并明确建议首先放宽哪项筛选条件。

Billing Troubleshooting

计费问题排查

If
```
health_check
```
returns a 402 error, check key-owner subscription entitlement first (user-level access), then confirm the key is active and not revoked.
Use
```
get_usage
```
after a successful health check to verify rate-limit posture for the current key.

若
```
health_check
```
返回402错误，首先检查密钥所有者的订阅权限（用户级访问），然后确认密钥是否有效且未被撤销。
成功完成健康检查后，使用
```
get_usage
```
验证当前密钥的速率限制状态。

References

参考资料

Use cases
API recipes
Response contracts

使用案例
API使用示例
响应约定